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Django 教程 


Django 安装 


在 安装 Django 前 ， 系 统 需要 已 经 安装 了 Python 的 开发 环境 。 接 下 来 我 们 来 具体 看 下 不 同系 统 
下 Django 的 安装 。 


Window 下 安 玫 Django 
如 果 你 还 未 安装 Python 环境 需要 先 下 载 Python 安装 包 。 
1、Python 下 载 地 址 : https://www.python.org/downloads/ 


2、Django 下 载 地 址 : https://www.djangoproject.com/download/ 


注意 : 目前 Django 1.6.x 以 上 版 本 已 经 完全 兼容 Python 3.x。 


Python 安装 (已 安装 的 可 跳 过 ) 


安装 Python 你 只 需要 下 载 python-x.x.x.msi 文 件 ， 然 后 一 直 点 击 "Next" 按 钮 即 可 。 


安装 完成 后 你 需要 设置 Python 环境 变量 。 右 击 计算 机 -> 属性 -> 高 级 -> 环境 变量 -> 修改 系统 变 
量 path， 添 加 Python 安装 地 址 ， 本 文 实例 使 用 的 是 CA\Python33， 你 需要 根据 你 实际 情况 来 安 


站 
To 


Django 安装 


下 载 Django 压缩 包 ， 解 压 并 和 Python 安装 目录 放 在 同一 个 根 目 录 ， 进 入 Django 目录 ， 执 行 
python setup.py install， 然 后 开始 安装 ，Django 将 要 被 安装 到 Python 的 Lib 下 site-packages。 


然后 是 配置 环境 变量 ， 将 这 几 个 目录 添加 到 系统 环境 变量 中 : C:/Python33/Lib/site- 
packages/django;C:/Python33/Scripts。 添加 完成 后 就 可 以 使 用 Django 的 django-admin.py 命 
今 新 建 工程 了 。 


python import django 
django.get_version() 


如 果 输 出 了 Django 的 版 本 号 说 明 安 装 正确 。 
Linux 上 安 委 Django 


yum 安装 方法 


以 下 安装 位 于 Centos Linux 环境 下 安装 ， 如 果 是 你 的 Linux 系统 是 ubuntu 请 使 用 apt-get 命 


全 
To 


默认 情况 下 Linux 环境 已 经 支持 了 Python。 你 可 以 在 终端 输入 Python 命令 来 查看 是 否 已 经 安 


站 
To 


Python 2.7.3 (default， Aug 1 2012, 05:14:39) [GCC 4.6.3] on linux2 Type "help", 


-中 启 





安装 setuptools 


yum install setuptools 


完成 之 后 ， 就 可 以 使 用 easy_install 命令 安装 django 


easy_install django 


之 后 我 们 在 python 解 释 器 输入 以 下 代码 : 


[root@solar django]# python Python 2.7.3 (default, May 15 2014, 14:49:08) [GCC 4.8 


图 
我 们 可 以 看 到 输出 了 Dijango 的 版 本 号 ， 说 明 安 装 成 功 。 





pip 命令 安 委 方法 


pip install Django 


源码 安装 方法 
下 载 源 码 包 : https://www.djangoproject.com/download/ 
输入 以 下 命令 并 安装 : 


tar xzvf Django-X.Y.tar.gz # 解压 下 载 包 cd Django-X.Y # 进入 Django 目录 python setup.py ins 


“| 








安装 成 功 后 Django 位 于 Python 安装 目录 的 site-packages 目录 下 。 


Mac 下 安装 


下 载 

从 这 里 下 载 最 新 的 稳定 版 本 : DJango-1.x.ytargz， 在 页 面 右 侧 列表 下 载 ， 如 下 图 :， 记 住 是 
最 新 的 官方 版 本 哦 .其 中 x.y 是 版 本 号 。 进 入 你 下 载 该 文件 的 文件 夹 目 录 ， 执 行 如 下 命令 : (Mac 
下 默认 是 /Users/xxx/Downloads，xxx 是 你 的 用 户 名 ) 


$ tar zxvf Django-1.x.y.tar.gz 


你 也 可 以 从 Github 上 下 载 最 新 版 ， 地 址 : https://github.com/django/django : 


git clone https://github.com/django/django.git 


安 委 
进入 解压 后 的 目录 : 


cd Django-1.x.y 
sudo python setup.py install 


安装 成 功 后 会 输出 以 下 信息 : 


a Processing dependencies for Django==1.x.y Finished processing dependencies for Djan 
= Ta 
再 进入 我 们 的 站 点 目录 ， 创 建 Django 项 目 : 





$ django-admin.py startproject testdj 


启动 服务 : 


cd testdj # 切换 到 我 们 创建 的 项 目 $ _ python manage.py runserver ..... Starting development serve 


4 一 








以 上 信息 说 明 ， 项 目 已 启动 ， 访 问 地 址 为 http://127.0.0.1:8000/。 


Django 创建 第 一 个 项 目 


本 章 我 们 将 介绍 Django 管理 工具 及 如 何 使 用 Django 来 创建 项 目 ， 第 一 个 项 目 我 们 以 
HelloWorld 来 命令 项 目 。 


Django 管理 工具 


安装 Django 之 后 ， 您 现在 应 该 已 经 有 了 可 用 的 管理 工具 django-admin.py。 我 们 可 以 使 用 
django-admin.py 来 创建 一 个 项 目 : 


我 们 可 以 来 看 下 django-admin.py 的 命令 介绍 : 


[root@solar ~]# django-admin.py 
Usage: django-admin.py subcommand [options] [args] 


Options: 

-V VERBOSITY, --verbosity=VERBOSITY 
Verbosity level; 0=minimal output, 1=normal output, 
2=verbose output, 3=very verbose output 

--Settings=SETTINGS The Python path to a settings module, e.g. 
"myproject.settings.main". If this isn't provided, the 
DJANGO_SETTINGS MODULE environment variable will be 
used. 

--pythonpath=PYTHONPATH 
A directory to add to the Python path, e.g. 
"/home/djangoprojects/myproject". 


--traceback Raise on exception 
--Version show program's version number and exit 
-h, --help show this help message and exit 


Type 'django-admin.py help <subcommand>' for help on a specific subcommand. 


Available subcommands: 


[django] 
check 
cleanup 
compilemessages 
createcachetable 


创建 第 一 个 项 目 
使 用 django-admin.py 来 创建 HelloWorld 项 目 : 


django-admin.py startproject Helloworld 


创建 完成 后 我 们 可 以 查看 下 项 目的 目录 结构 : 


[root@solar ~]# cd Helloworld/ 
[root@solar Helloworld]# tree 


|-- Helloworld 
| |-- init .py 
| |-- settings.py 
| |-- urls.py 
| 


~-- wsgi.py 
~-- manage.py 


目录 说 明 : 


。 HelloWorld: 项 目的 容器 。 

。 manage.py: 一 个 实用 的 命令 行 工具 ， 可 让 你 以 各 种 方式 与 该 Django 项 目 进行 交互 。 
。 HelloWorld/init.py: 一 个 空 文件 ， 告 诉 Python 该 目录 是 一 个 Python 包 。 

。 HelloWorld/settings.py: 该 Django 项 目的 设置 /配置 。 

。 HelloWorld/urls.py: 该 Django 项 目的 URL 声明 ; 一 份 由 Django 驱动 的 网 站 "目录 "。 
。 HelloWorld/wsgi.py: 一 个 WSGI 兼容 的 Web 服务 器 的 入 口 ， 以 便 运 行 你 的 项 目 。 


接 下 来 我 们 进入 HelloWorld 目录 输入 以 下 命 伟 ， 启 动 服务 器 : 

python manage.py runserver 0.0.0.0:8000 
0.0.0.0 让 其 它 电 脑 可 连接 到 开发 服务 器 ，8000 为 端口 号 。 如 果 不 说 明 ， 那 么 端口 号 默认 为 
8000。 


在 浏览 器 输入 你 服务 器 的 ip 及 端口 号 ， 如 果 正 常 启动 ， 输 出 结果 如 下 : 


视图 和 URL 配置 
在 先前 创建 的 HelloWorld 目录 下 的 HelloWorld 目录 新 建 一 个 view.py 文件 ， 并 输入 代码 : 


from django.http import HttpResponse 


def hello(request): 
return HttpResponse("Hello world ! ") 


接着 ， 绑 定 URL 与 视图 函数 。 打 开 urls.py 文件 ， 删 除 原来 代码 ， 将 以 下 代码 复制 粘贴 到 
urls.py 文件 中 : 


from django,conf ,Urls import * 
from Helloworld.view import hello 


urlpatterns = patterns("", 
('^hello/$', hello), 
) 


整个 目录 结构 如 下 : 


[root@solar Helloworld]# tree 


- Helloworld 

|-- _init .py 

|-- _ init _.pyc 

|-- settings.py 

|-- settings.pyc 

[=> Urle py # Url 配置 

|-- Urls.pyc 
|-- view.py # 添加 的 视图 文件 
|-- view.pyc # 编译 后 的 视图 文件 
|-- wsgi.py 

“-- Wsgi.pyc 
- manage.py 


完成 后 ， 启 动 Django 开发 服务 器 ， 并 在 浏览 器 访问 打开 浏览 器 并 访问 : 


注意 : 项 目 中 如 果 代 码 有 改动 ， 服 务 器 会 自动 监测 代码 的 改动 并 自动 重新 载 入 ， 所 以 如 果 你 
已 经 启动 了 服务 器 则 不 需 手动 重启 。 


Django 模板 


在 上 一 章节 中 我 们 使 用 django.http.HttpResponse() 来 输出 "Hello World ! "。 该 方式 将 数据 与 
视图 混合 在 一 起 ， 不 符合 Django 的 MVC 思 想 。 


本 章节 我 们 将 为 大 家 详细 介绍 Django 模板 的 应 用 ， 模 板 是 一 个 文本 ， 用 于 分 离 文档 的 表现 形 
式 和 内 容 。 


模板 应 用 实例 


我 们 接着 上 一 章节 的 项 目 将 在 HelloWorld 目录 底下 创建 templates 目录 并 建立 hello.html 文 
件 ， 整 个 目录 结构 如 下 : 


Helloworld/ 
- Helloworld 
|-- init .py 
__init_ _.pyc 


| 
|-- settings.py 
|-- settings.pyc 
|-- urls.py 
|-- urls.pyc 
|-- view.py 
|-- view.pyc 
I wsgi.py 

- wsgi.pyc 
- manage.py 
- templates 

~-- hello.html 


hello.html 文件 代码 如 下 : 
<h1i>{{ hello }}</hi1> 


从 模板 中 我 们 知道 变量 使 用 了 双 括 号 。 


接 下 来 我 们 需要 向 Django 说 明 模 板 文 件 的 路 径 ， 修 改 HelloWorld/settings.py， 修 改 
TEMPLATES 中 的 DIRS 为 [BASE_DIR+"/templates",]， 如 下 所 示 : 


TEMPLATES = [ 
{ 
'BACKEND': 'django.template.backends.django.DjangoTemplates', 
'DIRS': [BASE_ DIR+"/templates",], 
'APP_DIRS': True, 
'OPTIONS': { 

'context_processors': [ 
'django.template.context_processors.debug', 
'django.template.context_processors.request', 
'django.contrib.auth.context_processors.auth', 
'django.contrib.messages.context_processors.messages', 

]， 

}, 


我 们 现在 修改 view.py， 增 加 一 个 新 的 对 象 ， 用 于 向 模板 提交 数据 : 


# -*- coding: utf-8 -*- 


#from django.http import HttpResponse 
from django.shortcuts import render 


def hello(request): 
context 
context['hello'] = 'Hello World!' 
return render(request, 'hello.html', context) 


可 以 看 到 ， 我 们 这 里 使 用 render 来 蔡 代 之 前 使 用 的 HttpResponse。render 还 使 用 了 一 
context 作 为 参数 。 


context 字典 中 元 素 的 键 值 "hello" 对 应 了 模板 中 的 变量 "{{ hello }}"。 


再 访问 访问 http:/192.168.45.3:8000/hello/， 可 以 看 到 页 面 


这 样 我 们 就 完成 了 使 用 模板 来 输出 数据 ， 从 而 实现 数据 与 视图 分 离 。 
接 下 来 我 们 将 具体 介绍 模板 中 常用 的 语法 规则 。 


Django 模板 标签 
if/else 标签 


基本 语法 格式 如 下 : 


{% if condition %} 
... display 
{% endif %} 


或 者 : 


个 字典 


{% if condition1 %} 
，display 1 

{% elif condiiton2 %} 
，display 2 

{% else %} 
. display 3 

{% endif %} 


根据 条 件 判断 是 否 输 出 。if/else 支持 族 套 。 


{% if %} 标签 接受 and ， or 或 者 not 关键 字 来 对 多 个 变量 做 判断 ， 或 者 对 变量 取 反 (not 
)， 例 如 : 


{% if athlete_ list and coach list %} 
athletes 和 coaches 变量 都 是 可 用 的 。 
{% endif %} 


for 标签 
{% for %} 人 允许 我 们 在 一 个 序列 上 和 返 代 。 


与 Python 的 for 语句 的 情形 类 似 ， 循 环 语法 是 for X in Y ，Y 是 要 迭代 的 序列 而 X 是 在 每 一 个 特 
定 的 循环 中 使 用 的 变量 名 称 。 


每 一 次 循环 中 ， 模 板 系统 会 泻 染 在 {% for %} 和 {% endfor %} 之 间 的 所 有 内 容 。 


例如 ， 给 定 一 个 运动 员 列 表 athlete_list 变量， 我 们 可 以 使 用 下 面 的 代码 来 显示 这 个 列表 : 


<ul> 

{% for athlete in athlete list %} 
<l1i>{{ athlete.name }}</1i> 

{% endfor %} 

</ul> 


给 标签 增加 一 个 reversed 使 得 该 列表 被 反 向 迭代 : 


{% for athlete in athlete list reversed %} 


{% endfor %} 


可 以 馈 套 使 用 {% for %} 标签 : 


{% for athlete in athlete list %} 
<h1i>{{ athlete.name }}</h1> 
<ul> 
{% for Sport in athlete.sports_ played %} 
<1i>{{ sport }}</1i> 
{% endfor %} 
</UJ> 
{% endfor %} 


ifequal/ifnotequal 标签 


{% ifequal %} 标签 比较 两 个 值 ， 当 他 们 相等 时 ， 显 示 在 {% ifequal %} 和 {% endifequal %} 之 
中 所 有 的 值 。 


下 面 的 例子 比较 两 个 模板 变量 user 和 currentuser : 


{% ifequal user currentuser %} 
<h1i>welcome!</h1> 
{% endifequal %} 


和 {% if %} 类 似 ， {% ifequal %} 支持 可 选 的 {% else%} 标签 : 8 


{% ifequal section 'sitenews' %} 
<h1>Site News</h1> 

{% else %} 
<h1i>No News Here</h1> 

{% endifequal %} 


注释 标签 
Django 注释 使 用 供 扒 。 


{# 这 是 一 个 注释 #} 


模板 过 滤器 可 以 在 变量 被 显示 前 修改 它 ， 过 滤器 使 用 管道 字符 ， 如 下 所 示 : 


{{ name|lower }} 


{{ name }} 变量 被 过 滤器 lower 处 理 后 ， 文 档 大 写 转 换文 本 为 小 写 。 
过 滤 管 道 可 以 被 套 接 ， 既 是 说 ， 一 个 过 滤器 管道 的 输出 又 可 以 作为 下 一 个 管道 的 输入 : 


{{ my_list|firstlupper }} 


以 上 实例 将 第 一 个 元 素 并 将 其 转化 为 大 写 。 
有 些 过 滤器 有 参数 。 过 滤器 的 参数 跟随 冒号 之 后 并 且 总 是 以 双 引 号 包含 。 例如 : 


{{ bioltruncatewords:"30" }} 


这 个 将 显示 变量 bio 的 前 30 个 词 。 


其 他 过 滤器 : 


。 addslashes : 添加 反 斜 杠 到 任何 反 斜 枉 、 单 引号 或 者 双 引 号 前 面 。 
。 date : 按 指定 的 格式 字符 串 参 数 格式 化 date 或 者 datetime 对 象 ， 实 例 : 


{{ pub_dateldate:"F j, Y" }} 
。 length : 返回 变量 的 长 度 。 


include 标签 
{% include %} 标签 允许 在 模板 中 包含 其 它 的 模板 的 内 容 。 
下 面 这 两 个 例子 都 包含 了 nav.html 模板 : 


{% include "nav.html" %} 


模板 继承 


模板 可 以 用 继承 的 方式 来 实现 复 用 。 
接 下 来 我 们 先 创建 之 前 项 目的 templates 目录 中 添加 base.html 文件 ， 代 码 如 下 : 


<html> 
<head> 
<title>Hello World!</title> 
</head> 


<body> 
<h1i>Hello World!</hi1> 
{% block mainbody %} 
<p>original</p> 
{% endblock %} 
</body> 
</html> 


以 上 代码 中 ， 名 为 mainbody 的 block 标 签 是 可 以 被 继承 者 们 蔡 换 掉 的 部 分 。 
所 有 的 {% block %} 标签 告诉 模板 引擎 ， 子 模板 可 以 重 载 这些 部 分 。 


hello.html 中 继承 base.html， 并 替换 特定 block，hello.html 修 改 后 的 代码 如 下 : 


{% extends "base.html" %} 


{% block mainbody %} 
<p> 继 承 了 base.html 文件 </p> 
{% endblock %} 


第 一 行 代码 说 明 hello.html 继 承 了 base.html 文件 。 可 以 看 到 ， 这 里 相同 名 字 的 block 标 签 用 以 
替换 base.html 的 相应 block。 


重新 访问 地 址 http://192.168.45.3:8000/hello/， 输 出 结果 如 下 : 


Django 模型 


Django 对 各 种 数据 库 提 供 了 很 好 的 支持 ， 包 括 : PostgreSQL、MySQL、SQLite、Oracle。 


Django 为 这 些 数 据 库 提供 了 统一 的 调用 API。 我 们 可 以 根据 自己 业务 需求 选择 不 同 的 数据 
库 。 


MySQL 是 Web 应 用 中 最 常用 的 数据 库 。 本 章节 我 们 将 以 Mysql 作为 实例 进行 介绍 。 你 可 以 
通过 本 站 的 MySQL 教程 了 解 更 多 Mysql 的 基础 知识 。 


数据 库 配 置 
我 们 在 项 目的 settings.py 文件 中 找到 DATABASES 配置 项 ， 将 其 信息 修改 为 : 


DATABASES = { 
'default': { 
'ENGINE': 'django.db.backends.mysql', 
'NAME': "test '， 
USERS I teste 
"PASSWORD ' : 'test123', 
"HOST ' :' Localhost ' ， 
"PORT ' : '3306 ' ， 


上 面包 含 数据 库 名 称 和 用 户 的 信息 ， 它 们 与 MySQL 中 对 应 数据 库 和 用 户 的 设置 相同 。Django 
根据 这 一 设置 ， 与 MySQL 中 相应 的 数据 库 和 用 户 连接 起 来 。 


定义 模型 


创建 APP 


Dijango 规 定 ， 如 果 要 使 用 模型 ， 必 须要 创建 一 个 app。 我 们 使 用 以 下 命令 创建 一 个 TestModel 
的 app: 


python manage.py startapp TestModel 


目录 结构 如 下 : 


Helloworld 

- TestModel 
|-- _init .py 
|-- admin.py 
|-- models.py 
|-- tests.py 
~-- Views.py 


我 们 修改 TestModel/models.py 文 件 ， 代 码 如 下 : 


# models.py 
from django.db import models 


class Test(models.Model): 
name = models.CharField(max_length=20) 


以 上 的 类 名 代表 了 数据 库 表 名 ， 且 继承 了 models.Model， 类 里 面 的 字段 代表 数据 表 中 的 字段 
(name)， 数 据 类 型 则 由 CharField (相当 于 varchar) 、DateField (相当 于 datetime) ， 
max_length 参数 限定 长 度 。 


接 下 来 在 settings.py 中 找到 INSTALLED_APPS 这 一 项 ， 如 下 : 


INSTALLED_APPS = ( 
'django.contrib.admin', 
"django,contrib.auth'， 
"django,contrib.contenttypes ' ， 
'django.contrib.sessions', 
'django.contrib.messages', 
'django.contrib.staticfiles', 
'TestModel', # 添加 此 项 


在 命令 行 中 运行 python manage.py syncdb， 看 到 几 行 "Creating table..…" 的 字样 ， 你 的 数据 表 
就 创建 好 了 。 


Creating tables ... 


Creating table TestModel test # 我 们 自 定义 的 表 


表 名 组 成 结构 为 : app 名 _ 类 名 (如 : TestModel test) 。 


注意 : 尽管 我 们 没有 在 models 给 表 设 置 主键 ， 但 是 Django 会 自动 添加 一 个 id 作为 主键 。 


效 据 库 操 作 


接 下 来 我 们 在 HelloWorld 目录 中 添加 testdb.py 文件 ， 并 修改 urls.py : 


from django,conf,Urls import * 

from Helloworld.view import hello 
from Helloworld.testdb import testdb 
urlpatterns = patterns("", 


('Ahello/$', hello), 
('^testdb/$', testdb), 


添加 数据 
添加 数据 需要 先 创 建 对 象 ， 然 后 再 执行 save 画 数 ， 相 当 于 SQL 中 的 INSERT : 


# -*- Coding: utf-8 -*- 
from django.http import HttpResponse 
from TestModel.models import Test 
# 数据 库 操作 
def testdb(request ) : 
test1 = Test(name='w3cschool.cc') 


test1.Save() 
return HttpResponse("<p> 数 据 添加 成 功 ! </p>") 


访问 http://192.168.45.3:8000/testdb/ 就 可 以 看 到 数据 添加 成 功 的 提示 。 


获取 数据 


Django 提 供 了 多 种 方式 来 获取 数据 库 的 内 容 ， 如 下 代码 所 示 : 


# -*- Coding: utf-8 -*- 
from django.http import HttpResponse 
from TestModel.models import Test 


# 数据 库 操作 

def testdb(request ) : 
# 初始 化 
response = "" 
response1 = "" 


# 通过 objects 这 个 模型 管理 器 的 a11( ) 获 得 所 有 数据 行 ， 相 当 于 SQL 中 的 SELECT * FROM 
list = Test.objects.all() 


# filter 相 当 于 SQL 中 的 WHERE， 可 设置 条 件 过 滤 结 果 
response2 = Test.objects.filter(id=1) 


# 获取 单个 对 象 
response3 = Test.objects.get(id=1) 


# 限制 返回 的 数据 相当 于 SQL 中 的 OFFSET 0 LIMIT 2; 
Test.objects.order_by('name' )[0:2] 


# 数 据 排序 
Test.objects.order_by("id") 


# 上 面 的 方法 可 以 连锁 使 用 


Test.objects.filter(name="w3cschool.cc").order_by("id") 


# 输出 所 有 数据 
for var in list: 
response1 += var.name + " " 
response = responsel1 
return HttpResponse("<p>" + response + "</p>") 


输出 结果 如 下 图 所 示 : 


更 新 数据 
修改 数据 可 以 使 用 save() 或 update(): 


# -*- Coding: utf-8 -*- 
from django.http import HttpResponse 
from TestModel.models import Test 


# 数据 库 操作 
def testdb(request ) : 
# 修改 其 中 一 个 id=1 的 name 字 段 ， 再 save， 相 当 于 SQL 中 的 UPDATE 
test1 = Test.objects.get(id=1) 
test1.name = 'w3cschool 菜 乌 教 程 ' 
test1.save() 


# 另外 一 种 方式 
#Test.objects.filter(id=1).update(name='w3cschool 菜 乌 教 程 ' ) 


# 修改 所 有 的 列 
# Test.objects.all().update(name='w3cschool 菜 乌 教 程 ' ) 


return HttpResponse("<p> 修 改 成 功 </p>") 


删除 数据 
测 除 数据 库 中 的 对 象 只 需 调用 该 对 象 的 delete() 方 法 即 可 : 


# -*- coding: utf-8 -*- 
from django.http import HttpResponse 
from TestModel.models import Test 


# 数据 库 操作 

def testdb(request ) : 
# 删除 id=1 的 数据 
test1 = Test.objects.get(id=1) 
test1.delete() 


# 另外 一 种 方式 
# Test.objects.filter(id=1).delete() 


# 删除 所 有 数据 
# Test.objects.all().delete() 


return HttpResponse("<p> 删 除 成 功 </p>") 


Django 表单 


HTML 表 单 是 网 站 交互 性 的 经 典 方式 。 本 章 将 介绍 如 何 用 Django 对 用 户 提交 的 表单 数据 进行 
处 理 。 


HTTP 请 求 


HTTP 协 议 以 "请 求 一 回复 "的 方式 工作 。 客 户 发 送 请 求 时 ， 可 以 在 请 求 中 附加 数据 。 服 务 器 通 
过 解析 请 求 ， 就 可 以 获得 客户 传 来 的 数据 ， 并 根据 URL 来 提供 特定 的 服务 。 


GET 方法 
我 们 在 之 前 的 项 目 中 创建 一 个 search.py 文件 ， 用 于 接收 用 户 的 请 求 : 


# -*- Coding: utf-8 -*- 


from django.http import HttpResponse 
from django.shortcuts import render_to_response 


# 表单 
def search_form(request): 
return render_to_response('search form.html') 


# 接收 请 求 数据 
def search(request): 
request.encoding="'utf-8' 
if 'q' in request.6GET: 
message = ' 你 搜索 的 内 容 为 : ' + request.GET['q'].encode('utf-8') 
else: 
message = ' 你 提交 了 空 表单 ' 
return HttpResponse(message) 


在 模板 目录 template 中 添加 search_form.html 表单 : 


<html> 
<head> 
<meta charset="utf-8" /> 
<title>Search - w3cschool.cc</title> 
</head> 
<body> 
<form action="/search/" method="get"> 
<input type="text" name="q"> 
<input type="submit" value="Search"> 
</form> 
</body> 
</html> 


urls.py 规则 修改 为 如 下 形式 : 


from django.conf .urls import * 

from Helloworld.view import hello 
from Helloworld.testdb import testdb 
from Helloworld import search 


urlpatterns = patterns("", 
('^hello/$', hello), 
('^testdb/$', testdb), 
(r'Asearch-form/$', search.search_form), 
(r'Asearch/$', search.search), 


访问 地 址 : http://192.168.45.3:8000/search-form/ 并 搜索 ， 结 果 如 下 所 示 : 


POST 方法 
上 面 我 们 使 用 了 GET 方 法 。 视 图 显示 和 请 求 处理 分 成 两 个 男 数 处理 。 


提交 数据 时 更 常用 POST 方 法 。 我 们 下 面 使 用 该 方法 ， 并 用 一 个 URL 和 你 理 画 数 ， 同 时 显示 视 
图 和 义理 请 求 。 


我 们 在 tmplate 创建 post.html : 


<html> 
<head> 
<meta charset="utf-8" /> 
<title>Search - w3cschool.cc</title> 
</head> 
<body> 
<form action="/search-post/" method="post"> 
{% csrf_token %} 
<input type="text" name="q"> 
<input type="submit" value="Submit"> 
</form> 


<p>{{ rlt }}</p> 
</body> 
</html> 


在 模板 的 末尾 ， 我 们 增加 一 个 rlt 记 号 ， 为 表格 处 理 结果 预 留 位 置 。 


表格 后 面 还 有 一 个 {% csrf token %} 的 标签 。csrf 全 称 是 Cross Site Request Forgery。 这 是 
Django 提 供 的 防止 伪装 提交 请 求 的 功能 。POST 方 法 提交 的 表格 ， 必 须 有 此 标签 。 


在 HelloWorld 目 录 下 新 建 search2.py 文件 并 使 用 search_post 范 数 来 处 理 POST 请 求 : 


# -*- coding: utf-8 -*- 


from django.shortcuts import render 
from django.core.context_processors import csrf 


# 接收 POST 请 求 数据 
def search_ post(request): 
ctx ={} 
ctx.update(csrf(request)) 
If request .POST: 
ctx['rit'] = request.POST['9q'] 
return render(request, "post.htmil", ctx) 


urls.py 规则 修改 为 如 下 形式 : 


from django.conf .urls import * 

from Helloworld.view import hello 
from Helloworld.testdb import testdb 
from Helloworld import search 

from Helloworld import search2 


urlpatterns = patterns("", 
('^hello/$', hello), 
('^testdb/$', testdb), 
(r'Asearch-form/$', search.search_form), 
(r'Asearch/$', search.search), 
(r'Asearch-post/$', search2.search_post), 


访问 http://192.168.45.3:8000/search-post/ 显示 结果 如 下 : 


完成 以 上 实例 后 ， 我 们 的 目录 结构 为 : 


Helloworld 

-- Helloworld 
|-- _init .py 
|-- _ init _.pyc 
|-- models.pyc 
|-- search.py 
|-- Search.pyc 
|-- Search2 .py 
|-- Search2.pyc 
|-- settings.py 
|-- settings.pyc 
|-- testdb.py 
|-- testdb .pyc 
|-- urls.py 
|-- urls.pyc 
|-- view.py 
|-- view.pyc 
1-- wsgi.py 

-- Wsgi.pyc 


-- admin.py 
-- models.py 
-- models.pyc 
-- tests.py 
~-- Views.py 
manage .py 
-- templates 
|-- base.html 
|-- hello.html 
|-- post.html 
`“-- search_form.html 


3 directories, 29 files 


Request 对 象 
每 个 view 本 数 的 第 一 个 参数 是 一 个 HttpRequest 对 象 ， 就 像 下面 这 个 hello() 画 数 : 


from django.http import HttpResponse 


def hello(request): 
return HttpResponse("Hello world") 


HttpRequest 对 象 包含 当前 请 求 URL 的 一 些 信息 : 


属性 描述 
path 请 求 页 面 的 全 路 径 ,不 包括 域名 一 例如 ， "/hello/"。 
请 求 中 使 用 的 HTTP 方 法 的 字符 串 表 示 。 全 大 写 表 示 。 例 如 : 
method if request.method == 'GET': do something() 
elif request.method == 'POST': do _ something_ else() 
GET 包含 所 有 HTTP GET 参 数 的 类 字典 对 象 。 参 见 QueryDict 文档 。 


包含 所 有 HTTP POST 参数 的 类 字典 对 象 。 参 见 QueryDict 文档 。 服 务 
器 收 到 空 的 POST 请 求 的 情况 也 是 有 可 能 发 生 的 。 也 就 是 说 ， 表 单 form 
通过 HTTP POST 方法 提交 请 求 ， 但 是 表单 中 可 以 没有 数据 。 因 此 ， 不 


POST 


REQUEST 


COOKIES 


EBEES 


META 


USser 


session 


raw_post_data 


能 使 用 语句 if request.POST 来 判断 是 否 使 用 HTTP POST 方法 ; 应 该 使 
用 if request.method == "POST" (参见 本 表 的 method 属 性 )。 注 意 : 
POST 不 包括 flle-upload 信 息 。 参 见 FILES 属 性 。 


为 了 方便 ， 该 属性 是 POST 和 GET 属 性 的 集合 体 ， 但 是 有 特殊 性 ， 先 
查找 POST 属性 ， 然 后 再 查找 GET 属 性 。 借 鉴 PHP's s_REQUEST 。 例 
如 ， 如 果 GET = 人 name john 和 POST— /age 34 , 则 
REQUEST["name"] 的 值 是 "john"，REQuEST["age"] 的 值 是 "34". 强 烈 建 议 
ee and POST, 因 为 这 两 个 属性 更 加 显 式 化 ， 写 出 的 代码 也 更 易 
理解 。 


包含 所 有 cookies 的 标准 Python 字典 对 象 。Keys 和 values 都 是 字符 串 。 
参见 第 12 章 ， 有 关于 cookies 更 详细 的 讲解 。 


包含 所 有 上 传 文件 的 类 字典 对 象 。FILES 中 的 每 个 Key 都 是 <input 
type="file" name="" /> 标签 中 name 属 性 的 值 . FILES 中 的 每 个 value 同 
时 也 是 一 个 标准 Python 字典 对 象 ， 包 含 下 面 三 个 Keys: filename : 上 
传 文件 名 ,用 Python 字符 串 表 示 content-type : 上 传 文件 的 Content 
type content : 上 传 文件 的 原始 内 容 注意 : 只 有 在 请 求 方法 是 
POST， 并 且 请 求 页 面 中 <form> 有 enctype="multipart/form-data" 属 性 
时 FILES 才 拥有 数据 。 否 则 ，FILES 是 一 个 空 字 典 。 


包含 所 有 可 用 HTTP 头 部 信息 的 字典 。 例如 : coNTENT_LENGTH 
CONTENT_TYPE ”QUERY_STRING : 未 解析 的 原始 查询 字符 串 

REMOTE_ADDR : 客户 端 I|P 地 址 REMoTE_HosT : 客户 端 主机 名 
SERVER_NAME : 服务 器 主机 名 sERVER_PORT : 服务 器 端口 META 中 这 些 
头 加 上 前 级 HTTP_ 最 为 Key, 例如 : HTTP_ACCEPT_ENCODING 
HTTP_ACCEPT_LANGUAGE ”HTTP_HOST : 客户 发 送 的 HTTP 主 机 头 信息 
HTTP_REFERER : referring 页 HTTP_USER_AGENT : 客户 端的 user-agent 字 
符 串 HTTP_x_BENDER : X-Bender 头 信息 


是 一 个 django.contrib.auth.models.User 对 象 ， 代 表 当 前 登录 的 用 户 。 
如 果 访 问 用户 当 前 没有 登录 ，user 将 被 初始 化 为 
django.contrib.auth.models.AnonymousUser 的 实例 。 你 可 以 通过 user 
的 is_authenticated() 方 法 来 辨别 用 户 是 否 登 

录 : if request,user.is_ authenticated(): 

# Do something for logged-in users. else: 

# Do something for anonymous users. 只 有 激活 Django 中 的 
AuthenticationMiddleware 时 该 属性 才 可 用 


唯一 可 读 写 的 属性 ， 代 表 当 前 会 话 的 字典 对 象 。 只 有 激活 Django 中 的 
session 支 持 时 该 属性 才 可 用 。 参见 第 12 章 。 


原始 HTTP POST 数据 ， 未 解析 过 。 高 级 处 理 时 会 有 用 处 。 


Request 对 象 也 有 一 些 有 用 的 方法 : 


方法 


getitem(key) 


has_key() 
get_full_path() 


is_secure() 


描述 
返回 GET/POST 的 键 值 , 先 取 POST, 后 取 GET。 如 果 键 不 存在 抛 出 
KeyError。 这 是 我 们 可 以 使 用 字典 语法 访问 HttpRequest 对 象 。 例 
如 ,request["foo"] 等 同 于 先 request.POST["foo"] 然后 
request.GET["foo"] 的 操作 。 
检查 request.GET or request.POST 中 是 否 包 含 参数 指定 的 Key。 


返回 包含 查询 字符 串 的 请 求 路 径 。 例 如 ， "/music/bands/the_beatles/? 
print=true" 


如 果 请 求 是 安全 的 ， 返 回 True， 就 是 说 ， 发 出 的 是 HTTPS 请 求 。 


QueryDict 对 象 


在 HttpRequest 对 象 中 , GET 和 POST 属 性 是 django.http.QueryDict 类 的 实例 。 


QueryDict 类 似 字 典 的 自 定 义 类 ， 用 来 处 理 单 键 对 应 多 值 的 情况 。 


QueryDict 实 现 所 有 标准 的 词典 方法 。 还 包括 一 些 特 有 的 方法 : 


方法 


getitem _ 


Setitem_ 


get ( ) 


update() 


items() 


values() 


描述 
和 标准 字典 的 处 理 有 一 点 不 同 ， 就 是 ， 如 果 Key 对 应 多 个 
Value，getitem() 返 回 最 后 一 个 value。 
设置 参数 指定 key 的 value 列 表 ( 一 个 Python list)。 注 意 : 它 只 能 在 一 个 
mutable QueryDict 对 象 上 被 调用 (就 是 通过 copy() 产 生 的 一 个 QueryDict 
对 象 的 拷贝 ). 
如 果 key 对 应 多 个 value，get() 返 回 最 后 一 个 value。 
参数 可 以 是 QueryDict， 也 可 以 是 标准 字典 。 和 标准 字典 的 update 方 法 不 
同 ， 该 方法 添加 字典 items， 而 不 是 替换 它们 : 
>>> q = QueryDict('a=1') >>> 9q = q.copy() # to make it mutable 


>>> q.update({'a': '2'}) >>> q.getlist('a'’) ['1', '2'] 
>>>。 0 a neturns eeRLast 2 


和 标准 字典 的 items() 方 法 有 一 点 不 同 ,该 方法 使 用 单 值 逻辑 的 getitem(): 


>>> q = QueryDict('a=i&a=2&a=3') >>> q.items() [('a', '3')] 


和 标准 字典 的 values() 方 法 有 一 点 不 同 ,该 方法 使 用 单 值 逻 辑 的 getitem(): 


此 外 , QueryDict 也 有 一 些 方法 ， 如 下 表 : 


copy() 


getlist(key) 


setlist(key, list ) 


appendlist(key,item) 


setlistdefault(key,1ist) 


lists() 


urlencode() 


描述 
返回 对 象 的 拷贝 ， 内 部 实现 是 用 Python 标 准 库 的 


copy.deepcopy()。 该 拷贝 是 mutable( 可 更 改 的 ) 
说 ， 可 以 更 改 该 拷贝 的 值 。 


返回 和 参数 key 对 应 的 所 有 值 ， 作 为 一 个 Python list 返 回 。 
如 果 key 不 存在 ， 则 返回 空 list。 Its guaranteed to return a 
list of some sort.. 


就 是 





设置 key 的 值 为 list_ (unlike setitem ()). 
添加 item 到 和 key 关 联 的 内 部 list. 


和 setdefault 有 一 点 不 同 ， 它 接受 list 而 不 是 单个 value 作 为 
参数 。 


和 items() 有 一 点 不 同 , 它 会 返回 key 的 所 有 值 ， 作 为 一 个 list， 
例如 : >>> q = QueryDict('a=1&a=2&a=3') >>> q.lists() 
a [Ll 

返回 一 个 以 查询 字符 串 格 式 进行 格式 化 后 的 字符 串 (e.g.， 
"a=2&b=3&b=5"). 


Django Admin 管理 工具 


Django 提供 了 基于 web 的 管理 工具 。 


Django 自 动 管理 工具 是 django.contrib 的 一 部 分 。 你 可 以 在 项 目的 settings.py 中 的 
INSTALLED_APPS 看 到 它 : 


INSTALLED_APPS = ( 
"django,contrib.admin'， 
"django,contrib.auth'， 
"django,contrib.contenttypes ' ， 
'django.contrib.sessions', 
'django.contrib.messages', 
'django.contrib.staticfiles', 


django.contrib 是 一 套 庞大 的 功能 集 ， 它 是 Django 基 本 代码 的 组 成 部 分 。 


激活 管理 工具 
通常 我 们 在 生成 项 目 时 会 在 urls.py 中 自动 设置 好 ， 我 们 只 需 去 掉 注 释 即 可 。 
配置 项 如 下 所 示 : 


from django.contrib import admin 
admin.autodiscover() 


# And include this URLpattern... 
urlpatterns = patterns("'', 
# .,， 
(r'Aadmin/', include(admin.site.urls)), 
大 本 这 


当 这 一 切 都 配置 好 后 ，Django 管 理工 具 就 可 以 运行 了 。 


使 用 管理 工具 


启动 开发 服务 器 ， 然 后 在 浏览 器 中 访问 : http://yoursite:8000/admin/， 得 到 如 下 界面 : 


你 可 以 通过 命令 python manage.py createsuperuser 来 创建 超级 用 户 ， 如 下 所 示 : 


# _ python manage.py createsuperuser 

Username (leave blank to use 'root'): admin 
Email address: admin@w3cschool.cc 

Password: 

Password (again): 

Superuser created successfully. 

[root@solar Helloworld]# 


之 后 输入 用 户 名 密码 登录 ， 界 面 如 下 : 


为 了 让 admin 界 面 管理 某 个 数据 模型 ， 我 们 需要 先 注册 该 数据 模型 到 admin。 上 比如， 我们 之 前 
在 TestModel 中 已 经 创建 了 模型 Test 。 修 改 TestModel/admin.py: 


from django.contrib import admin 
from TestModel.models import Test 


# Register your models here. 
admin.site.register(Test) 


刷新 后 即 可 看 到 Testmodel 数据 表 : 


复 杀 模型 
管理 页 面 的 功能 强大 ， 完 全 有 能 力 义 理 更 加 复杂 的 数据 模型 。 


先 在 TestModel/models.py 中 增加 一 个 更 复杂 的 数据 模型 : 


from django.db import models 


# Create your models here. 
class Contact(models,Model) : 


name = models.CharField(max_length=200) 
age = models.IntegerField(default=0) 
email = models.EmailField() 


def _ unicode (self): 
return self.name 


class Tag(models.Model) : 
contact = models.ForeignKey(Contact ) 
name = models.CharField(max_length=50) 


def _ unicode (self): 
return self.name 


这 里 有 两 个 表 。Tag 以 Contact 为 外 部 键 。 一 个 Contact 可 以 对 应 多 个 Tag。 


我 们 还 可 以 看 到 许多 在 之 前 没有 见 过 的 属性 类 型 ， 比 如 IntegerField 用 于 存储 整数 。 


在 TestModel/admin.py 注册 多 个 模型 并 显示 : 


from django.contrib import admin 
from TestModel.models import Test, Contact, Tadg 


# Register your models here. 
admin.site.register([Test, Contact, Tag]) 


刷新 管理 页 面 ， 显 示 结 果 如 下 : 


在 以 上 管理 工具 我 们 就 能 进行 复杂 模型 操作 。 


自 定义 表单 


我 们 可 以 自 定义 管理 页 面 ， 来 取代 默认 的 页 面 。 上 比如 上 面 的 "add" 页 面 。 我 们 想 只 显示 name 和 
email 部 分 。 修 改 TestModel/admin.py: 


from django.contrib import admin 
from TestModel.models import Test,Contact,Tag 


# Register your models here. 
class ContactAdmin(admin.ModelAdmin): 
fields = ('name', 'email') 


admin.site.register(Contact, ContactAdmin) 
admin.site.register([Test, Tag]) 


以 上 代码 定义 了 一 个 ContactAdmin 类 ， 用 以 说 明 管 理 页 面 的 显示 格式 。 
里 面 的 fields 属 性 定义 了 要 显示 的 字段 。 


由 于 该 类 对 应 的 是 Contact 数 据 模 型 ， 我 们 在 注册 的 时 候 ， 需 要 将 它们 一 起 注册 。 显 示 效 果 如 
下 : 


我 们 还 可 以 将 输入 栏 分 块 ， 每 个 栏 也 可 以 定义 自己 的 格式 。 修 改 TestModel/admin.py 为 : 


from django.contrib import admin 
from TestModel.models import Test,Contact,Tag 


# Register your models here. 
class ContactAdmin(admin.ModelAdmin): 
fieldsets = ( 
['Main',{ 
'fields':('name', 'email'), 
}], 
['Advance',{ 
'classes': ('collapse',), # CSS 
fields ('age',), 
}] 
) 


admin.site.register(Contact, ContactAdmin) 
admin.site.register([Test, Tag]) 


上 面 的 栏目 分 为 了 Main 和 Advance 两 部 分 。classes 说 明 它 所 在 的 部 分 的 CSS 格 式 。 这 里 让 
Advance 部 分 隐藏 : 


Advance 部 分 旁边 有 一 个 Show 按钮 ， 用 于 展开 ， 展 开 后 可 点 击 Hide 将 其 隐藏 ， 如 下 图 所 
示 : 


内 联 (Inline) 显 示 


上 面 的 Contact 是 Tag 的 外 部 键 ， 所 以 有 外 部 参考 的 关系 。 


而 在 默认 的 页 面 显示 中 ， 将 两 者 分 离开 来 ， 无 法 体现 出 两 者 的 从 属 关 系 。 我 们 可 以 使 用 内 联 
显示 ， 让 Tag 附 加 在 Contact 的 编辑 页 面 上 显示 。 


修改 TestModeladmin.py : 


from django.contrib import admin 
from TestModel.models import Test, Contact, Tadg 


# Register your models here. 
class TagInline(admin.TabularIinline): 
model = Tag 


class ContactAdmin(admin.ModelAdmin): 
inlines = [TagInline] # Inline 
fieldsets = ( 
['Main',{ 
'fields':('name', 'email'), 
}], 
['Advance',{ 
'classes': ('collapse',), 
Eee 下 ds :0 A 
}] 


) 


admin.site.register(Contact, ContactAdmin) 
admin.site.register([Test]) 


显示 效果 如 下 : 


列表 页 的 显示 


在 Contact 输 入 数 条 记录 后 ，Contact 的 列表 页 看 起 来 如 下 : 


我 们 也 可 以 自 定 义 该 页 面 的 显示 ， 比 如 在 列表 中 显示 更 多 的 栏目 ， 只 需要 在 ContactAdmin 中 
增加 list_display 属 性 : 
from django.contrib import admin 
from TestModel.models import Test, Contact, Tag 
# Register your models here. 
class ContactAdmin(admin.ModelAdmin): 
list_display = ('name','age', 'email') # list 


admin.site.register(Contact, ContactAdmin) 
admin.site.register([Test, Tag]) 


刷新 页 面 显示 效果 如 下 : 


搜索 功能 在 管理 大 量 记 录 时 非常 有 ， 我 们 可 以 使 用 search_fields 为 该 列表 页 增加 搜索 栏 : 
from django.contrib import admin 
from TestModel.models import Test, Contact, Tag 
# Register your models here. 
class ContactAdmin(admin.ModelAdmin): 
list_display = ('name','age', 'email') 
search_fields = ('name',) 


admin.site.register(Contact, ContactAdmin) 
admin.site.register([Test]) 


在 本 实例 中 我 们 搜索 了 name 为 w3cschool.cc( 本 站 域名 ) 的 记录 ， 显 示 结 果 如 下 : 


Django Admin 管理 工具 还 有 非常 多 实用 的 功能 ， 感 兴趣 的 同学 可 以 深入 研究 下 。 


Django Nginx+uwsgi 安装 配置 


在 前 面 的 章节 中 我 们 使 用 python manage.py runserver 来 运行 服务 器 。 这 只 适用 测试 环境 
中 使 用 。 


正式 发 布 的 服务 ， 我 们 需要 一 个 可 以 稳定 而 持续 的 服务 器 ， 比 如 apache, Nginx, lighttpd 等 ， 
本 文 将 以 Nginx 为 例 。 

my 十 i 

安装 基础 开发 包 

Centos 下 安装 步骤 如 下 : 


yum groupinstall "Development tools" 
yum install zlib-devel bzip2-devel pcre-devel openssl-devel ncurses-devel sqlite-devel re 


加 | 放 


CentOS 自 带 Python 2.4.3， 但 我 们 可 以 再 安装 Python2.7.5 : 





Cans 

wget http://python.org/ftp/python/2.7.5/Python-2.7.5.tar.bz2 
tar xvf Python-2.7.5.tar.bz2 

cd Python-2.7.5 

./configure --prefix=/usr/local 

make && make altinstall 


安装 Python 包 管理 
easy_install 包 https://pypi.python.org/pypi/distribute 
安装 步 又 : 


cde 

wget https://pypi.python.org/packages/source/d/distribute/distribute-0.6.49.tar.gz 
tar xf distribute-0.6.49.tar.gz 

cd distribute-0.6.49 

python2.7 setup.py install 

easy_install --version 


pip 包 : https://pypi.python.org/pypi/pip 


安装 pip 的 好 处 是 可 以 pip list、pip uninstall 管理 Python 包 ， easy_install 没有 这 个 功能 ， 只 有 
uninstall 


安装 uwsgi 


uwsgi:https://pypi.python.org/pypi/uWSGI 


uwsgi 参 数 详解 : http://uwsgi-docs.readthedocs.org/en/latest/Options.html 


pip install uwsgi 
uwsgi --version # 查 看 uwsgi 版 本 


测试 uwsgi 是 否 正 常 : 
新 建 test.py 文 件 ， 内 容 如 下 : 


def application(env, start_response): 
start_response('200 OK', [('Content-Type','text/html')]) 
return "Hello World" 


然后 在 终端 运行 : 
Uwsgi --http :8001 --wsgi-file test.py 


在 浏览 器 内 输入 : http://127.0.0.1:8001， 查 看 是 否 有 "Hello World" 输 出 ， 若 没有 输出 ， 请 检 
查 你 的 安装 过 程 。 


安装 Django 
pip install django 


测试 django 是 否 正常 ， 运 行 : 


django-admin.py startproject demosite 
cd demosite 
python2.7 manage.py runserver 0.0.0.0:8002 


在 浏览 器 内 输入 : http:/127.0.0.1:8002， 检 查 django 是 否 运行 正常 。 


cd -~ 

wget http://nginx.org/download/nginx-1.5.6.tar.gz 
tar xf nginx-1.5.6.tar.gz 

cd nginx-1.5.6 

./configure --prefix=/usr/local/nginx-1.5.6 \ 
--with-http_stub_status_module \ 
--with-http_gzip_static_module 

make && make install 


你 可 以 阅读 Nginx 安装 配置 了 解 更 多 内 容 。 


uwsgi 配置 


uwsgi 支 持 ini、xml 等 多 种 配置 方式 ， 本 文 以 ini 为 例 ， 在 /ect/ 目 录 下 新 建 uwsgi9090.ini， 添 加 
如 下 配置 : 


[uwsgi] 

socket = 127.0.0.1:9090 

master = true // 主 进程 

vhost = true // 多 站 模式 

no-site = true // 多 站 模式 时 不 设置 入 口 模块 和 文件 
workers = 2 // 子 进程 数 

reload-mercy = 10 

vacuum = true // 退 出 、 重 启 时 清理 文件 


max-requests = 1000 

limit-as = 512 

buffer-size = 30000 

pidfile = /var/run/uwsgi9090.pid //pid 文 件 ， 用 于 下 面 的 脚本 启动 、 停 止 该 进程 
daemonize = /website/uwsgi9090 .1og 


Nginx 配置 
找到 nginx 的 安装 目录 (如 : /usr/local/nginx/) ， 打 开 conf/nginx.conf 文 件 ， 修 改 server 配 置 : 


server { 
listen 80; 
server_name localhost,; 


location / { 
include uwsgi_ params,; 

















uwsgi_pass 127.0.0.1:9090; // 必 须 和 uwsgi 中 的 设置 一 致 
uwsgi_param UWSGI_SCRIPT demosite.wsgi; // 入 口 文件 ， 即 wsgi .py 相对 于 项 目 根 目 录 的 位 
uwsgi param UWSGI_CHDIR /demosite; // 项 目 根 目录 


index index.html index.htm; 
client max_body_size 35m; 





你 可 以 阅读 Nginx 安装 配置 了 解 更 多 内 容 。 


设置 完成 后 ， 在 终端 运行 : 


TutorialsPoint 后 端 教程 


Uwsgi --ini /etc/uwsgi9090.ini & 
/usr/local/nginx/sbin/nginx 


在 浏览 器 输入 : http://127.0.0.1， 你 就 可 以 看 到 django 的 "lt work" 了 。 


Django Nginx+uwsgi 安装 配置 
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W3School Node.js 教 程 


来 源 : Node.js 教 程 


整理 : 飞龙 


Node.js 简介 


简单 的 说 Node.js 就 是 运行 在 服务 端的 JavaScript。 
Node.js 是 一 个 基于 Chrome JavaScript 运行 时 建立 的 一 个 平台 。 


Node.js 是 一 个 事件 驱动 |/O 服 务 端 JavaScript 环 境 ， 基 于 Google 的 V8 引擎 ，V83 引 擎 执行 
Javascript 的 速度 非常 快 ， 性 能 非常 好 。 


谁 运 合 阅读 本 教程 ? 


如 果 你 是 一 个 前 端 程序 员 ， 你 不 懂 的 像 PHP、Python 或 Java 等 动态 编程 语言 ， 然 后 你 想 创 建 
自己 的 服务 ， 那 么 Node.js 是 一 个 非常 好 的 选择 。 


Node.js 是 运行 在 服务 端的 JavaScript， 如 果 你 熟悉 Javascript， 那 么 你 将 会 很 容易 的 学 会 
Node.js。 


当然 ， 如 果 你 是 后 端 程序 员 ， 想 部 署 一 些 高 性 能 的 服务 ， 那 么 学 习 Node.js 也 是 一 个 非常 好 的 
选择 。 


学 习 本 教程 前 你 需要 了 解 


在 继续 本 教程 之 前 ， 你 应 该 了 解 一 些 基本 的 计算 机 编程 术语 。 如 果 你 学 习 过 Javascript,PHP， 
Java 等 编程 语言 ， 将 有 助 于 你 更 快 的 了 解 Node.js 编 程 。 


第 一 个 Node.js 程 序 : Hello World | 
脚本 模式 


以 下 是 我 们 的 第 一 个 Node.js 程 序 : 


console.log("Hello World"); 


保存 该 文件 ， 文 件 名 为 helloworld.js， 并 通过 node 命 合 来 执行 : 


node helloworld.js 


程序 执行 后 ， 正 常 的 话 ， 就 会 在 终端 输出 Hello World。 


交互 模式 
打开 终端 ， 键 入 node 进 入 命令 交互 模式 ， 可 以 输入 一 条 代码 语句 后 立即 执行 并 显示 结果 ， 例 
如 : 


$ node 
> console.log('Hello World!'); 
Hello World! 


Node.js 安装 配置 


本 章节 我 们 将 向 大 家 介绍 在 window 和 Linux 上 安装 Node.js 的 方法 。 
本 安装 教程 以 Node.js v0.10.26 版 本 为 例 。 


Node.js 安 装 包 及 源码 下 载 地 址 为 : http://www.nodejs.org/download/。 


根据 不 同 平台 系统 选择 你 需要 的 Node.js 安 装 包 。 


注意 : Linux 上 安装 Node.js 需 要 安装 Python 2.6 或 2.7 ， 不 建议 安装 Python 3.0 以 上 版 本 。 


Windowv 上 安装 Nodejjs 


Windows 安装 包 (.msi) : 

32 位 安装 包 下 载 地 址 : http://nodejs.org/dist/v0.10.26/node-v0.10.26-x86.msi 

64 位 安装 包 下 载 地 址 : http://nodejs.org/dist/v0.10.26/x64/node-v0.10.26-x64.msi 
安装 步骤 : 

一 


步骤 1: 双击 下 载 后 的 安装 包 node-v0.10.26-x86.msi， 如 下 所 示 : 


AN 


步骤 2 : 点 击 以 上 的 Run( 运 行 )， 将 出 现 如 下 界面 : 


步骤 3 : 勾 选 接受 协议 选项 ， 点 击 next (下 一 步 ) 按钮 : 


步骤 4 : Node.js 默 认 安 装 目 录 为 "C:\Program Files\nodejs\"，, 你 可 以 修改 目录 ， 并 点 击 
next (下 一 步 ) 


步骤 5 : 点击 树 形 图 标 来 选择 你 需要 的 安装 模式 ,然后 点 击 下 一 步 next (下 一 步 ) 
步骤 6 :点 击 Install (安装 ) 开始 安装 Node.js。 你 也 可 以 点 击 Back (返回 ) 来 修改 先前 的 配 


置 。 然后 并 点 击 next (下 一 步 ) 


点 击 Finish (完成 ) 按钮 退出 安装 向 导 。 


检测 PATH 环境 变量 是 否 配置 了 Node.js， 点 击 开 始 =》 运 行 =》 输 入 "cmd" => 输入 命 
今 "path"， 输 出 如 下 结 


PATH=C:\oraclexe\app\oracle\product\10.2.0\server\bin;C:\Windows\system32; 
C:\Windows;C:\Windows\System32\Wbem;C:\Windows\System32\WindowsPowerShell\vi.0\; 
c:\python32\python;C:\MinGW\bin;C:\Program Files\GTK2-Runtime\lib; 

C:\Program Files\MySQL\MySQL Server 5.5\bin;C:\Program Files\nodejs\; 
C:\Users\rg\AppData\Roaming\npm 


我 们 可 以 看 到 环境 变量 中 已 经 包含 了 C:\Program Files\nodejs\ 


检查 Node.js 版 本 


Windows 二 进 制 文件 (.exe) 安 装 : 

32 位 安装 包 下 载 地 址 : http://nodejs.org/dist/v0.10.26/node.exe 

64 位 安装 包 下 载 地 址 : http://nodejs.org/dist/v0.10.26/x64/node.exe 
安装 步 又 


步骤 1 : 双击 下 载 的 安装 包 Node.exe ， 将 出 现 如 下 界面 : 
点 击 Run (运行 ) 按钮 将 出 现 命令 行 窗 口 : 


版 本 测试 


进入 node.exe 所 在 的 目录 ， 如 下 所 示 : 


如 果 你 获得 以 上 输出 结果 ， 说 明 你 已 经 成 功 安装 了 Node.js。 


Linux 上 安 疼 Node.js 


Ubuntu 安装 


以 下 部 分 我 们 将 介绍 在 Ubuntu Linux 下 安装 Node.js 。 其 他 的 Linux 系 统 ， 如 Centos 等 类 似 如 
下 安装 步骤 。 


在 Github 上 获取 Node.js 源码 : 


在 完成 下 载 后 ， 将 源码 包 名 改 为 "node'。 


修改 目录 权限 : 


使 用 './configure' 创建 编译 文件 。 


编译 : make。 


完成 安装 : make install。 


最 后 我 们 输入 'node --version' 命令 来 查看 Node.js 是 否 安装 成 功 。 


centOS 下 安 冯 nodejs 
1、 下 载 源码 ， 你 需要 在 http://nodejs.org/ 下 载 最 新 的 Nodejs 版 本 ， 本 文 以 v0.10.24 为 例 : 


cd /usr/local/src/ 
wget http://nodejs.org/dist/v9e.10.24/node-vO.10.24.tar.gz 


2、 解 压 源 码 


tar zxvf node-VvV0.10.24.tar.gz 


3、 编译 安装 


cd node-v90.10.24 

./configure --prefix=/usr/local/node/0.10.24 
make 

make install 


4、 配置 NODE_HOME， 进 入 profile 编 辑 环 境 变量 


vim /etc/profile 


设置 nodejs 环 境 变量 ， 在 expot PATH USER LOGNAME MAIL HOSTNAME HISTSIZE 
HISTCONTROL 一 行 的 上 面 添加 如 下 内 容 : 


#set for nodejs 
export NODE_HOME=/Uusr/local/node/9.10.24 
export PATH=$NODE_HOME/bin:$PATH 


:Wwq 保 存 并 退出 ， 编 译 /etc/profile 使 配置 生效 


source /etc/profile 


验证 是 否 安装 配置 成 功 


node -V 


输出 v0.10.24 表示 配置 成 功 


/usr/local/node/90.10.24/1lib/node modules/ 


注 : Nodejs 官网 提供 了 编译 好 的 Linux 二 进 制 包 ， 你 也 可 以 下 载 下 来 直接 应 用 。 


a- A 

Node.js 创建 第 一 个 应 用 

如 果 我 们 使 用 PHP 来 编写 后 端的 代码 时 ， 需 要 Apache 或 者 Nginx 的 HTTP 服务 器 ， 并 配 上 
mod php5 模块 和 php-cgi。 

从 这 个 角度 看 ， 整 个 "接收 HTTP 请 求 并 提供 Web 页 面 "的 需求 根本 不 需 要 PHP 来 处 理 。 


不 过 对 Node.js 来 说 ， 概 念 完全 不 一 样 了 。 使 用 Node.js 时 ， 我 们 不 仅仅 在 实现 一 个 应 用 ， 
同时 还 实现 了 整个 HTTP 服务 器 。 事 实 上 ， 我 们 的 Web 应 用 以 及 对 应 的 Web 服务 器 基本 上 
是 一 样 的 。 


在 我 们 创建 Node.js 第 一 个 "Hello, World!" 应 用 前 ， 让 我 们 先 了 解 下 Node.js 应 用 是 由 哪 几 部 
分 组 成 的 : 


1. 引入 required 模块 : 我 们 可 以 使 用 require 指令 来 载 和 人 Node.js 模块 。 
2. 创建 服务 器 : 服务 器 可 以 监听 客户 端的 请 求 ， 类似 于 Apache 、Nginx 等 HTTP 服务 器 。 


3. 接收 请 求 与 响应 请 求 服务 器 很 容易 创建 ， 客 户 端 可 以 使 用 浏览 器 或 终端 发 送 HTTP 请 
求 ， 服 务 器 接收 请 求 后 返回 响应 数据 。 


创建 Node.js 应 用 


步骤 一 、 引 入 required 模块 
我 们 使 用 require 指令 来 裁 入 http 模块 ， 并 将 实例 化 的 HTTP 赋值 给 变量 http， 实 例如 下 : 


var http = require("http"); 


步骤 一 、 创 建 服务 器 


接 下 来 我 们 使 用 http.createServer() 方法 创建 服务 器 ， 并 使 用 listen 方法 绑 定 8888 端口 。 函 
数 通 过 request, response 参数 来 接收 和 响应 数据 。 


实例 如 下 ， 在 你 项 目的 根 目 录 下 创建 一 个 叫 serverjs 的 文件 ， 并 写 入 以 下 代码 : 

var http = require('http'); http.createServer(function (request, response) { // 发 送 上 
加 _ 
以 上 代码 我 们 完成 了 一 个 可 以 工作 的 HTTP 服务 器 。 





使 用 node 命令 执行 以 上 的 代码 : 


node server.js Server running at http://127.0.0.1:8888/ 


接 下 来 ， 打 开 浏 览 器 访问 http://127.0.0.1:8888/， 你 会 看 到 一 个 写 着 "Hello World" 的 网 页 。 


分 析 Node.js 的 HTTP 服务 器 : 


。 第 一 行 请 求 (require) Node.js 自 带 的 http 模块 ， 并 且 把 它 赋值 给 http 变量 。 

。 接 下 来 我 们 调用 http 模块 提供 的 函数 : createServer 。 这 个 函数 会 返回 一 个 对 象 ， 这 个 
对 象 有 一 个 叫做 listen 的 方法 ， 这 个 方法 有 一 个 数值 参数 ， 指定 这 个 HTTP 服务 器 监听 
的 端口 号 。 


Gif 实例 演示 


接 下 来 我 们 通过 Gif 图 为 大 家 演示 实例 操作 : 


NPM 使 用 介绍 


NPM 是 随同 NodeJS 一 起 安装 的 包 管 理工 具 ， 能 解决 NodeJS 代 码 部 署 上 的 很 多 问题 ， 常 见 的 
使 用 场景 有 以 下 几 种 : 


。 人 允许 用 户 从 NPM 服 务 器 下 载 别 人 编写 的 第 三 方 包 到 本 地 使 用 。 
。 多 许 用 户 从 NPM 服 务 器 下 载 并 安装 别人 编写 的 命令 行程 序 到 本 地 使 用 。 
。 多 许 用 户 将 自己 编写 的 包 或 命令 行程 序 上 传 到 NPM 服 务 器 供 别 人 使 用 。 


由 于 新 版 的 nodejs 已 经 集成 了 npm， 所 以 之 前 npm 也 一 并 安装 好 了 。 同 样 可 以 通过 输入 "npm 
-V" 来 测试 是 否 成 功 安装 。 命 合 如 下 ， 出 现 版 本 提示 表示 安装 成 功 : 


$ npm -V 
253350 


如 果 你 安装 的 是 旧版 本 的 npm， 可 以 很 容易 得 通过 npm 命令 来 升级 ， 命 令 如 下 : 


$ sudo npm install npm -g 
/usr/local/bin/npm -> /usr/local/lib/node_modules/npm/bin/npm-cli.js 
npm@2.14.2 /usr/local/lib/node_modules/npm 


会 全 器 档 
使 用 npm 命令 安 闻 模块 
npm 安装 Node.js 模块 语法 格式 如 下 : 
$ npm install <Module Name> 
以 下 实例 ， 我 们 使 用 npm 命令 安装 常用 的 Node.js web 框 架 模块 express: 


$ npm install express 


安装 好 之 后 ，express 包 就 放 在 了 工程 目录 下 的 node_modules 目录 中 ， 因 此 在 代码 中 只 需要 
通过 require('express') 的 方式 就 好 ， 无 需 指定 第 三 方 包 路 径 。 


var express = require('express ' ) ; 


全 局 安 委 与 本 地 安 委 


npm 的 包 安 装 分 为 本 地 安装 (local) 、 全 局 安装 (global) 两 种 ， 从 敲 的 命令 行 来 看 ， 差 别 
只 是 有 没有 -g 而 已 ， 比 如 


npm install express # 本 地 安装 
npm install express -g  # 全 局 安装 


如 果 出 现 以 下 错误 : 
npm err! Error: connect ECONNREFUSED 127.0.0.1:8087 
解决 办 法 为 : 


$ npm config set proxy null 


本 地 安装 
。 1. 将 安装 包 放 在 ./node_modules 下 (运行 npm 命令 时 所 在 的 目录 ) ， 如 果 没 有 
node_modules 目录 ， 会 在 当前 执行 npm 命令 的 目录 下 生成 node_modules 目录 。 
。 2. 可 以 通过 require() 来 引入 本 地 安装 的 包 。 
全 局 安 六 


。 1. 将 安装 包 放 在 /usr/local 下 。 
。 2. 可 以 直接 在 命令 行 里 使 用 。 
。 3. 不 能 通过 require() 来 引入 本 地 安装 的 包 。 


接 下 来 我 们 使 用 全 局 方式 安装 express 


$ npm install express -g 


安装 过 程 输出 如 下 内 容 ， 第 一 行 输出 了 模块 的 版 本 号 及 安装 位 置 。 


express@4.13.3 node_ modules/express 

-一 escape-htm161.0.2 

-一 range-parser@1.0.2 

-一 merge-descriptorsQ@1.0.0 

-一 array-flattenQ1.1.1 

-Cookie00.1.3 

-一 utils-mergeQ1.0.0 

-一 parseur161.3.0 

-一 Cookie-SsignatureQ1.0.6 

-一 methods@1.1.1 

-一 fresh@0.3.0 

-一 VaryQ@1.0.1 

-一 path-to-regexp@0.1.7 

-一 content-type@1.0.1 

-一 etagQ@1.7.0 

-一 Serve-static@1.10.0 

-一 content-disposition@0.5.0 

-一 depd@1.0.1 

-一 qs@4.0.0 

| 一 finalhandler@0.4.0 (unpipe@1.0.0) 

-一 on-finishedQ@2.3.0 (ee-first@1.1.1) 

| 一 proxy-addr61.0.8 (forwarded@0.1.90, ipaddr.js@1.0.1) 
-一 debugQ@2.2.0 (ms@0.7.1) 

| 一 type-is@1.6.8 (media-typer@0.3.0, mime-types@2.1.6) 
-一 acceptsQ1.2.12 (negotiator@0.5.3, mime-types@2.1.6) 
-一 send@0.13.0 (destroy@1.0.3, statusesQ@1.2.1, ms@0.7.1, mime@1.3.4, http-errors@1.3.1) 


了 | 
你 可 以 使 用 以 下 命令 来 查看 所 有 全 局 安装 的 模块 : 





$ npm ls -gd 


使 用 package.json 


package.json 位 于 模块 的 目录 下 ， 用 于 定义 包 的 属性 。 接 下 来 让 我 们 来 看 下 express 包 的 
package.json 文件 ， 位 于 node_modules/express/package.json 内 容 : 


{ 
"name": "express", 
"description": "Fast, unopinionated, minimalist web framework", 
VErSIOMNM .M13 
"author": { 
"name": "TJ Holowaychuk", 
"email": "tj@vision-media.ca" 
}, 
"contributors": [ 
{ 
"name": "Aaron Heckmann", 
"email": "aaron.heckmann+github@gmail.com" 
}, 
{ 
"name": "Ciaran Jessup", 
"email": "ciaranj@gmail.com" 
}, 
{ 
"name": "Douglas Christopher Wilson", 
"email": "doug@somethingdoug.com" 
}, 
{ 
"name": "Guillermo Rauch", 


"email": "rauchg@gmail.com" 


{ 
"name": "Jonathan Ong", 
"email": "me@jongleberry.com" 
}, 
{ 
"name": ”Roman Shtylman", 
"email": "shtylmantexpressjs@gmail.com" 
}, 
{ 
"name": "Young Jae Sim", 
"email": "hanul@hanul.me" 
} 
], 
eAlulG EmnS Ee MI 


"repository": { 


}, 


"type": OE 
"url": "git+https://github.com/strongloop/express 


"homepage": "http://expressjs.com/", 
"keywords": [ 


], 


"express", 
"framework", 
"sinatra", 
yaaebr 
St 
eS Ef ul 
"router", 


"dependencies": { 


}, 


accepts 和 一 4 241227 
"array-flatten": "1.1.1", 
"content-disposition": "0.5.0", 
"content-type™:, "~1.0.1", 
COOKTe pO 
"cookie-signature": "1.0.6", 
“debUg "~2.2.0" 

"depd": "~1.0.1", 
"escape-html": "1.0.2", 

“etag” "~1.7.0"., 


"finalhandler": "0.4.0", 
"fresh": "0.3.0", 
"merge-descriptors": "1.0.0", 
"methods": "~1.1.1", 
"on-finished": "~2.3.0", 
“parseurl "~1.3.0", 
"path-to-regexp": "0.1.7", 
"proxy-addr": "~1.0.8", 
ES "4.0.0", 
"range-parser": "~1.0.2", 
"send": "0.13.0", 
"serve-static": "~1.10.0", 
"type-is": "~1.6.6", 
"utils-merge": "1.0.0", 
VA Ol 


"devDependencies": { 


上 FIELSR Omen 
SO RO 
"istanbul": "0.3.17", 
"marked": "0.3.5", 
mgeChTa ne 25200 
"should": "7.0.2", 
“supertest": "1.0.1", 


"body-parser": "~1.13.3", 
"connect-redis": "~2.4.1", 
"cookie-parser": "~1.3.5", 
"cookie-session": "~1.2.0", 
"express-session": "~1.11.3", 


"jade": "~1.11.0", 


git" 


"method-override": "~2.3.5", 
"morgan": "~1.6.1", 
"multiparty": "~4.1.2", 
VNnoStu 308 
}, 
"engines": { 
"node": ">= 0.10.0" 
}, 
fies el 
"LICENSE", 
"History.md", 
"Readme .md", 
"index.js", 
二 下 于 星 允 二 
]， 
SCIeTDkESs { 
"test": "mocha --require test/support/env --reporter spec --bail --check-leaks test/ 
"test-ci": "istanbul cover node modules/mocha/bin/_mocha --report lcovonly -- --requi 
"test-cov": "istanbul cover node modules/mocha/bin/_mocha -- --require test/support/e 
"test-tap": "mocha --require test/support/env --reporter tap --check-leaks test/ test 
}, 
"gitHead": "ef7ad681b245fba023843ce94f6bcb8e275bbb8e"， 
"bugs": 
"url": "https://github.com/strongloop/express/issues" 
}, 
"_id": "express@4.13.3", 
"_shasum": "ddb2f1fb4502bf33598d2b032b037960ca6c80a3 1" ， 
"_from": "express@*", 
"_npmVersion": "1.4.28", 
"_npmUser": { 
"name": "dougwilson", 
"email": "doug@somethingdoug.com" 
}, 
"maintainers": [ 
"name": "tjholowaychuk", 
"email": "tj@vision-media.ca" 
}, 
{ 
"name": "jongleberry", 
"email": "jonathanrichardong@gmail.com" 
}, 
{ 
"name": "dougwilson", 
"email": "doug@somethingdoug.com" 
}, 
{ 
"name": "rfeng", 
"email": "enjoyjava@gmail.com" 
}, 
{ 
"name": "aredridel", 
"email": "aredridel@dinhe.net" 
}, 
{ 
"name": "strongloop", 
"email": "callback@strongloop.com" 
}, 
{ 
"name": "defunctzombie", 
"email": "shtylman@gmail.com" 
} 
]， 
ost 
"shasum": "ddb2f1fb4502bf33598d2b032b037960ca6c80a3", 
"tarball": "http://registry.npmjs.org/express/-/express-4.13.3.tgz" 
}, 
"directories :1{}, 
"_resolved": "https://registry.npmjs.org/express/-/express-4.13.3.tgz", 


"readme": "ERROR: No README data found!" 


一 








到 








Package.json 属性 说 明 


name - 包 名 。 

version - 包 的 版 本 号 。 

description - 包 的 描述 。 

homepage - 包 的 官网 url 。 

author - 包 的 作者 姓名 。 
contributors - 包 的 其 他 贡献 者 姓名 。 


dependencies - 依赖 包 列 表 。 如 果 依 赖 包 没有 安装 ，npm 会 自动 将 依赖 包 安 装 在 
node_module 目录 下 。 


repository - 包 代 码 存放 的 地 方 的 类 型 ， 可 以 是 git 或 svn，git 可 在 Github 上 。 


main - main 字段 是 一 个 模块 ID， 它 是 一 个 指向 你 程序 的 主要 项 目 。 就 是 说 ， 如 果 你 包 的 
名 字 叫 express， 然 后 用 户 安装 它 ， 然 后 require("express")。 


keywords - 关键 字 


印 载 模 块 


我 们 可 以 使 用 以 下 命令 来 卸载 Node.js 模块 。 


$ npm uninstall express 


卸载 后 ， 你 可 以 到 /node_modules/ 目录 下 查看 包 是 否 还 存在 ， 或 者 使 用 以 下 命 合 查 看 : 


$ npm ls 


更 新 模块 


我 们 可 以 使 用 以 下 命令 更 新 模块 : 


$ npm update express 


搜索 模块 


使 用 以 下 来 搜索 模块 : 


$ npm search express 


创建 模块 


创建 模块 ，package.json 文件 是 必 不 可 少 的 。 我 们 可 以 使 用 NPM 生成 package.json 文件 ， 
生成 的 文件 包含 了 基本 的 结果 。 


This utility will walk you through _ creating a package.json file. 
It only covers the most common items, and tries to guess sensible defaults. 


See ‘npm help json ”for definitive documentation on these fields 
and exactly what they do. 


Use ‘npm install <pkg> --save afterwards to install a package and 
save it as a dependency in the package.json file. 


Press ^C at any time to quit. 

name: (node modules) runoob # 模块 名 

version: (1.0.0) 

description: Node.js 测试 模块 (www.runoob.com) # 描述 

entry point: (index.js) 

test command: make test 

git repository: https://github.com/runoob/runoob.git # Github 地 址 
keywords: 

author: 

license: (ISC) 

About to write to ...../node modules/package.json: # 生成 地 址 


{ 


"name": "runoob", 
"version": "1.0.0", 
"description": "Node.js 测试 模块 (www.runoob.com)"， 


Is this ok? (yes) yes 


以 上 的 信息 ， 你 需要 根据 你 自己 的 情况 输入 。 在 最 后 输入 "yes" 后 会 生成 package.json 文 
件 。 


接 下 来 我 们 可 以 使 用 以 下 命令 在 npm 资源 库 中 注册 用 户 (使 用 邮箱 注册 ) 


$ npm adduser 

Username: mcmohd 

Password : 

Email: (this IS public) mcmohd@gmail.com 


接 下 来 我 们 就 用 以 下 命令 来 发 布 模块 : 
$ npm publish 


如 果 你 以 上 的 步骤 都 操作 正确 ， 你 就 可 以 跟 其 他 模块 一 样 使 用 npm 来 安装 。 


版 本 号 


使 用 NPM 下 载 和 发 布 代码 时 都 会 接触 到 版 本 号 。NPM 使 用 语义 版 本 号 来 管理 代码 ， 这 里 简单 
介绍 一 下 。 


语义 版 本 号 分 为 X.Y.Z 三 位 ， 分 别 代表 主 版 本 号 、 次 版 本 号 和 补丁 版 本 号 。 当 代码 变更 时 ， 版 
本 号 按 以 下 原则 更 新 。 


。 如 果 只 是 修复 bug， 需 要 更 新 Z 位 。 
。 如 果 是 新 增 了 功能 ， 但 是 向 下 兼容 ， 需 要 更 新 Y 位 。 
。 如 果 有 大 变动 ， 向 下 不 兼容 ， 需 要 更 新 X 位 。 


版 本 号 有 了 这 个 保证 后 ， 在 申明 第 三 方 包 依赖 时 ， 除 了 可 依赖 于 一 个 固定 版 本 号 外 ， 还 可 依 
赖 于 某 个 范围 的 版 本 号 。 例 如 "argv": "0.0.x" 表 示 依 赖 于 0.0.x 系 列 的 最 新 版 argv。 


NPM 支 持 的 所 有 版 本 号 范围 指定 方式 可 以 查看 官方 文档 。 


NPM 常用 命 兮 
除了 本 章 介 绍 的 部 分 外 ，NPM 还 提供 了 很 多 功能 ，package.json 里 也 有 很 多 其 它 有 用 的 字 
段 。 
除了 可 以 在 npmjs.org/doc/ 查 看 官方 文档 外 ， 这 里 再 介绍 一 些 NPM 常 用 命令 。 
NPM 提 供 了 很 多 命 舍 ， 例 如 install 和 publish， 使 用 npm help 可 查看 所 有 命令 。 
。 NPM 提 供 了 很 多 命令 ， 例 如 install 和 publish ， 使 用 npm nelp 可 查看 所 有 命令 。 
。 使 用 npm help &lt;command&gt; 可 查看 某 条 命令 的 详细 帮助 ， 例 如 npm help install 。 


e。 在 package.json 所 在 目录 下 使 用 npm install ，-g 可 先 在 本 地 安装 当前 命令 行程 序 ， 可 
用 于 发 布 前 的 本 地 测试 。 


e@ 使 用 npm update &lt;package&gt; 可 以 把 当前 目 录 下 node_modules 子 目 录 里 边 的 对 应 模块 
更 新 至 最 新 版 本 。 


a 使 用 npm update &lt;package&gt; -g 可 以 把 全 局 安装 的 对 应 命令 行程 序 更 新 至 最 新 版 。 


。 使 用 npm cache clear 可 以 清空 NPM 本 地 缓存 ， 用 于 对 付 使 用 相同 版 本 号 发 布 新 版 本 代码 
的 人 。 


e 使 用 npm unpublish &lt;package&gt;@&lt;version&gt; 可 以 撤销 发 布 自己 发 布 过 的 某 个 版 
本 代码 。 


Node.js REPL( 交 互 式 解 释 器 ) 
Node.js REPL(Read Eval Print Loop: 交 互 式 解释 器 ) 表示 一 个 电脑 的 环境 ， 类 似 Window 系 
统 的 终端 或 Unix/Linux shell， 我 们 可 以 在 终端 中 输入 命 舍 ， 并 接收 系统 的 响应 。 
Node 自 带 了 交互 式 解 释 器 ， 可 以 执行 以 下 任务 : 
。 读 取 - 读 取 用 户 输入 ， 解 析 输 入 了 Javascript 数据 结构 并 存储 在 内 存 中 。 
。 执行 - 执行 输入 的 数据 结构 
。 打印 - 输出 结果 
。 循环 - 循环 操作 以 上 步骤 直到 用 户 两 次 按 下 ctrl-c 按钮 退出 。 
Node 的 交互 式 解 释 器 可 以 很 好 的 调试 Javascript 代码 。 
开始 学 习 REPL 


我 们 可 以 输入 以 下 命令 来 启动 Node 的 终端 : 


$ node 
> 


这 时 我 们 就 可 以 在 > 后 输入 简单 的 表达 式 ， 并 按 下 回 车 键 来 计算 结果 。 


简单 的 表达 式 运 算 

接 下 来 让 我 们 在 Node.js REPL 的 命 合 行 窗口 中 执行 简单 的 数学 运算 : 
node 

1 +4 

/2 


5 
3 6 


Oo 


加 


(2 


WO OO YE NY NO NA 


使 用 变量 
你 可 以 将 数据 存储 在 变量 中 ， 并 在 你 需要 的 使 用 它 。 
变量 声明 需要 使 用 var 关键 字 ， 如 果 没 有 使 用 var 关键 字 变 量 会 直接 打印 出 来 。 


使 用 var 关键 字 的 变量 可 以 使 用 console.log() 来 输出 变量 。 


$ node 

> X = 10 

10 

> Var y = 10 

undefined 

> X TYy 

20 

> console.log("Hello World") 
Hello World 

undefined 

> console.1log("www.runoob.com") 
www.runoob.com 


undefined 
多 行 表达 式 


Node REPL 支持 输入 多 行 表达 式 ， 这 就 有 点 类 似 JavaScript。 接 下 来 让 我 们 来 执行 一 个 do- 
while 循环 : 


$ node 
> var x=0 
undefined 
> do 
， X++， 
，, Console.log("x: ”十 xX); 
whle (Xx 00 


WIN 


ndefined 


Vcxxxxx 


… 三 个 点 的 符号 是 系统 自动 生成 的 ， 你 回 车 换行 后 即 可 。Node 会 自动 检测 是 否 为 连续 的 表达 
式 。 


下 划 线 (_) 变 量 
你 可 以 使 用 下 划 线 (_) 获 取 表 达 式 的 运算 结果 : 


$ node 

> var x = 10 
undefined 

> var y = 20 
undefined 
>Xx+y 

30 

> var sum = 
undefined 

> console.1og(sum) 
30 

undefined 

> 


REPL 命令 
。 ctrl + c - 退出 当前 终端 。 
。 ctrl + c 按 下 两 次 - 退出 Node REPL。 
。 ctrl+ d - 退出 Node REPL. 
。 向 上 /向 下 键 - 查看 输入 的 历史 命 兮 
。 tab 键 - 列 出 当前 命令 
。 .help - 列 出 使 用 命令 
。 .break - 退出 多 行 表达 式 
。 .clear - 退出 多 行 表达 式 
。 .save filename - 保存 当前 的 Node REPL 会 话 到 指定 文件 


e .load filename - 载 入 当前 Node REPL 会 话 的 文件 内 容 。 


停止 REPL 
前 面 我 们 已 经 提 到 按 下 两 次 ctrl + c 建 就 能 退出 REPL: 


$ node 
> 


(^C again to quit) 
> 


Gif 实例 演示 


接 下 来 我 们 通过 Gif 图 为 大 家 演示 实例 操作 : 


Node.js 回调 函数 
Node.js 异步 编程 的 直接 体现 就 是 回调 。 
异步 编程 依托 于 回调 来 实现 ， 但 不 能 说 使 用 了 回调 后 程序 就 异步 化 了 。 


回调 函数 在 完成 任务 后 就 会 被 调用 ，Node 使 用 了 大 量 的 回调 函数 ，Node 所 有 API 都 支持 回 
调 西 数 。 


例如 ， 我 们 可 以 一 按 读 取 文 件 ， 一 边 执行 其 他 命令 ， 在 文件 读 取 完 成 后 ， 我 们 将 文件 内 容 作 
为 回调 本 数 的 参数 返回 。 这 样 在 执行 代码 时 就 没有 阻塞 或 等 待 文件 |/O 操作 。 这 就 大 大 提高 了 
Node.js 的 性 能 ， 可 以 义理 大 量 的 并 发 请 求 。 


阻塞 代码 实例 
创建 一 个 文件 input.txt ， 内 容 如 下 : 


菜 乌 教程 官网 地 址 : www.runoob .com 


创建 main.js 文件 , 代码 如 下 : 


var fs = require("fs"),; 
var data = fs.readFileSync('input.txt'); 


console.log(data.toString()); 
console .10g( "程序 执行 结束 !"); 


以 上 代码 执行 结果 如 下 : 


$ node main.js 
菜 乌 教程 官网 地 址 : www. runoob .com 


程序 执行 结束 ! 


非 阻 塞 代 码 实例 
创建 一 个 文件 input.txt ， 内 容 如 下 : 


菜 乌 教程 官网 地 址 : www.runoob .com 


创建 main.js 文件 , 代码 如 下 : 


var fs = require("fs"),; 
fs.readFile('input.txt', function (err, data) { 
if (err) return console.error(err); 


console.log(data.toString()); 
}); 


console .10g( "程序 执行 结束 !"); 


以 上 代码 执行 结果 如 下 : 


$ node main.js 
程序 执行 结束 ! 
菜 乌 教程 官网 地 址 : www.runoob .com 


以 上 两 个 实例 我 们 了 解 了 阻塞 与 非 阻 塞 调用 的 不 同 。 第 一 个 实例 在 文件 读 取 完 后 才 执 行 完 程 
序 。 第 二 个 实例 我 们 呢 不 需要 等 待 文件 读 取 完 ， 这 样 就 可 以 在 读 取 文 件 时 同时 执行 接 下 来 的 
代码 ， 大 大 提高 了 程序 的 性 能 。 


因此 ， 阻 塞 按 是 按 顺 序 执行 的 ， 而 非 阻塞 是 不 需要 按 顺 序 的 ， 所 以 如 果 需 要 处 理 回调 函数 的 
参数 ， 我 们 就 需要 写 在 回调 函数 内 。 


Node.js 事件 循环 


Node.js 是 单 进 程 单 线程 应 用 程序 ， 但 是 通过 事件 和 回调 支持 并 发 ， 所 以 性 能 非常 高 。 
Node.js 的 每 一 个 API 都 是 异步 的 ， 并 作为 一 个 独立 线程 运行 ， 使 用 异步 画 数 调用 ， 并 人 处理 并 
发 。 

Node.js 基本 上 所 有 的 事件 机 制 都 是 用 设计 模式 中 观察 者 模式 实现 。 


Node.js 单线 程 类 似 进 入 一 个 while(true) 的 事件 循环 ， 直 到 没有 事件 观察 者 退出 ， 每 个 异步 事 
件 都 生成 一 个 事件 观察 者 ， De 


事件 驱动 程序 

Node.js 使 用 事件 驱动 模型 ， 当 web server 接 收 到 请 求 ， 就 把 它 关 闭 然 后 进行 人 处理， 然后 去 服 
务 下 一 个 web 请 求 。 

当 这 个 请 求 完成 ， 它 被 放 回 处 理 队 列 ， 当 到 达 队 列 开头 ， 这 个 结果 被 返回 给 用 户 。 


这 个 模型 非常 高 效 可 扩展 性 非常 强 ， 因 为 webserver 一 直接 受 请 求 而 不 等 待 任何 读 写 操 作 。 
(这 也 被 称 之 为 非 阻塞 式 10 或 者 事件 驱动 1D) 


在 事件 驱动 模型 中 ， 会 生成 一 个 主 循环 来 监听 事件 ， 当 检测 到 事件 时 触发 回调 酚 数 。 


整个 事件 驱动 的 流程 就 是 这 人 么 实现 的 ， 非 常 简洁 。 有 点 类 似 于 观察 者 模式 ， 事 件 相当 于 一 
主题 (Subject)， 而 所 有 注册 到 这 个 事件 上 的 处 理 范 数 相 当 于 观察 者 (Observer)。 


Node.js 有 多 个 内 置 的 事件 ， 我 们 可 以 通过 引入 events 模块 ， 并 通过 实例 化 EventEmitter 类 
来 绑 定 和 监听 事件 ， 如 下 实例 : 


// 引入 events 模块 

var events = require('events'); 

// 创建 eventEmitter 对 象 

Var eventEmitter = new events.EventEmitter(); 


以 下 程序 绑 定 事件 处 理 程序 : 


// 绑 定 事件 及 事件 的 处 理 程序 


eventEmitter.on('eventName', eventHandler); 


我 们 可 以 通过 程序 触发 事件 : 


// 触发 事件 


eventEmitter.emit('eventName'); 


实例 
创建 main.js 文件 ， 代 码 如 下 所 示 : 


// 引入 events 模块 

var events = require('events'); 

// 创建 eventEmitter 对 象 

Var eventEmitter = new events.EventEmitter(); 


// 创建 事件 处 理 程序 
var connectHandler = function connected() { 


console .10g(' 连 接 成 功 。'); 


// 触发 data_received 事件 
eventEmitter.emit('data_received'); 


} 


// 绑 定 connection 事件 处 理 程序 
eventEmitter.on('connection', connectHandler); 


// 使 用 匿名 函数 绑 定 data_received 事件 
eventEmitter.on('data received', function(){ 


console .10g( ' 数 据 接收 成 功 。' ) ; 
}); 


// 触发 connection 事件 
eventEmitter.emit('connection'); 


console.1og(" 程 序 执行 完毕 。" ) ; 


接 下 来 让 我 们 执行 以 上 代码 : 


$ node main.js 
连接 成 功 。 

数据 接收 成 功 。 
程序 执行 完毕 。 


Node 应 用 程序 是 如 何 工 作 的 ? 


在 Node 应 用 程序 中 ， 执 行 异步 操作 的 函数 将 回调 画 数 作为 最 后 一 个 参数 ， 回调 函数 接收 错 
误 对 象 作为 第 一 个 参数 。 


接 下 来 让 我 们 来 重新 看 下 前 面 的 实例 ， 创 建 一 个 input.txt ,文件 内 容 如 下 : 


菜 乌 教程 官网 地 址 : www. runoob .com 


创建 main.js 文件 ， 代 码 如 下 : 


var fs = require("fs"),; 
fs.readFile('input.txt', function (err, data) { 
If (err){ 
console.log(err.stack); 
return; 
console.log(data.toString()); 


}); 
console.1og(" 程 序 执行 完毕 " ) ; 


以 上 程序 中 fs.readFile() 是 异步 范 数 用 于 读 取 文件 。 如 果 在 读 取 文 件 过 程 中 发 生 错 误 ， 错 误 
err 对 象 就 会 输出 错误 信息 。 

如 果 没 发 生 错误 ，readFile 跳 过 err 对 象 的 输出 ， 文 件 内 容 就 通过 回调 范 数 输出 。 
执行 以 上 代码 ， 执 行 结果 如 下 : 


程序 执行 完毕 
菜 乌 教程 官网 地 址 : www.runoob .com 


接 下 来 我 们 删除 input.txt 文件 ， 执 行 结果 如 下 所 示 : 


程序 执行 完毕 
Error: ENOENT, open ‘input.txt' 


因为 文件 input.txt 不 存在 ， 所 以 输出 了 错误 信息 。 


Node.js EventEmitter 


Node.js 所 有 的 异步 VO 操作 在 完成 时 都 会 发 送 一 个 事件 到 事件 队列 。 


Node.js 里 面 的 许多 对 象 都 会 分 发 事件 : 一 个 net.Server 对 象 会 在 每 次 有 新 连接 时 分 发 一 个 事 
件 ， 一 个 fs.readStream 对 象 会 在 文件 被 打开 的 时 候 发 出 一 个 事件 。 所 有 这 些 产 生 事件 的 对 象 
都 是 events.EventEmitter 的 实例 。 


EventEmitter 类 


events 模块 只 提供 了 一 个 对 象 : events.EventEmitter。 EventEmitter 的 核心 就 是 事件 触发 与 
事件 监听 器 功能 的 封装 。 


你 可 以 通过 require("events"); 来 访问 该 模块 。 


// 引入 events 模块 

var events = require('events'); 

// 创建 eventEmitter 对 象 

Var eventEmitter = new events.EventEmitter(); 


EventEmitter 对 象 如 果 在 实例 化 时 发 生 错误 ， 会 触发 'error' 事件 。 当 添加 新 的 监听 器 
时 ，'newListener' 事件 会 触发 ， 当 监听 器 被 移 除 时 ，'removeListener' 事件 被 触发 。 


下 面 我 们 用 一 个 简单 的 例子 说 明 EventEmitter 的 用 法 : 


//event.js 文件 

Var EventEmitter = require('events').EventEmitter; 

var event = new EventEmitter(); 

event.on('some_event', function() { 
console,1og('some_event 事件 触发 ' ) ; 


setTimeout(function() { 


event.emit('some_event'); 
}, 1000); 


执行 结果 如 下 : 


运行 这 段 代 码 ，1 秒 后 控制 台 输 出 了 'some_event 事件 触发 '。 其 原理 是 event 对 象 注册 了 事 
件 some_event 的 一 个 监听 器 ， 然 后 我 们 通过 setTimeout 在 1000 毫秒 以 后 向 event 对 象 发 
送 事件 some_event， 此 时 会 调用 some_event 的 监听 器 。 


$ node event .js 
some_event 事件 触发 


EventEmitter 的 每 个 事件 由 一 个 事件 名 和 若干 个 参数 组 成 ， 事 件 名 是 一 个 字符 串 ， 通 常 表 达 
一 定 的 语义 。 对 于 每 个 事件 ，EventEmitter 支持 若干 个 事件 监听 器 。 


当 事 件 触发 时 ， 注 册 到 这 个 事件 的 事件 监听 器 被 依次 调用 ， 事 件 参 数 作为 回调 酚 数 参数 传 
递 。 


让 我 们 以 下 面 的 例子 解释 这 个 过 程 : 


//event .js 文件 

var events = redquire('events ' ) 

var emitter = new events.EventEmitter(); 

emitter.on('someEvent', function(arg1, arg2) { 
console.log('listener1', argi, arg2); 


}); 
emitter.on('someEvent', function(arg1, arg2) { 
console.log('listener2', argi1, arg2); 


}); 
emitter.emit('someEvent'，'argl1 参数 '，'arg2 参数 ' ) ; 


执行 以 上 代码 ， 运 行 的 结果 如 下 : /p> 


$ node event .js 
listener1 arg1 参数 arg2 参数 
listener2 argl 参数 arg2 参数 


以 上 例子 中 ，emitter 为 事件 someEvent 注册 了 两 个 事件 监听 器 ， 然 后 触发 了 someEvent 事 
件 。 


运行 结果 中 可 以 看 到 两 个 事件 监听 器 回调 函数 被 先后 调用 。 这 就 是 EventEmitter 最 简单 的 用 
法 。 


EventEmitter 提供 了 多 个 属性 ， 如 on 和 emit。on 画 数 用 于 绑 定 事件 画 数 ，emit 属性 用 于 触 
发 一 个 事件 。 接 下 来 我 们 来 具体 看 下 EventEmitter 的 属性 介绍 。 


方法 


方法 
addListener(event, listener) 


on(event, listener) 
once(event, listener) 


removeListener(event, 
listener) 


removeAllListeners([event]) 
setMaxListeners(n) 
listeners(event) 


emit(event, [arg1], [arg2], 
[.…]) 


类 方法 


方法 


listenerCount(emitter, event) 


事件 


事件 


newListener 


为 指定 事件 添加 一 个 监听 器 到 监听 器 数组 的 尾部 。 
为 指定 事件 注册 一 个 监听 器 ， 接 受 一 个 字符 串 event 和 一 : 
为 指定 事件 注册 一 个 单 次 监听 器 ， 即 监听 器 最 多 只 会 触发 


server-once( connectiom ,function (stream) console 


移 除 指定 事件 的 某 个 监听 器 ， 监 听 器 必须 是 该 事件 已 经 注 


var callback = function(stream) { console.1og(' Someone 


移 除 所 有 事件 的 所 有 监听 器 ， 如 果 指 定 事件 ， 则 移 除 指定 
默认 情况 下 ， EventEmitters 如 果 你 添加 的 监听 器 超过 10 
返回 指定 事件 的 监听 器 数组 。 


按 参 数 的 顺序 执行 每 个 监听 器 ， 如 果 事 件 有 注册 监听 返回 


描述 
返回 指定 事件 的 监听 器 数量 。 


描述 


event - 字符 串 ， 事 件 名 称 listener - 义理 事件 函数 该 事件 在 添加 新 
监听 器 时 被 触发 。 


event - 字符 串 ， 事 件 名 称 listener - 义理 事件 函数 从 指定 监听 器 数 


removeListener ”组 中 删除 一 


个 监听 器 。 需 要 注意 的 是 ， 此 操作 将 会 改变 处 于 被 删 监 听 


器 之 后 的 那些 监听 器 的 索引 。 


实例 


以 下 实例 通过 connection (连接 ) 事件 演示 了 EventEmitter 类 的 应 用 。 


创建 main.js 文件 ， 代 码 如 下 : 


var events = require('events'); 
Var eventEmitter = new events.EventEmitter(); 


// 监听 器 #1 

var listner1 = function listner1() { 
console.10g(' 监 听 器 listner1 执行 。')，; 

} 


// 监听 器 #2 

var listner2 = function listner2() { 
console.10g(' 监 听 器 listner2 执行 。'); 

} 


// 绑 定 connection 事件 ， 处 理事 数 为 listner1 
eventEmitter.addListener('connection', listner1); 


// 绑 定 connection 事件 ， 处 理事 数 为 listner2 
eventEmitter.on('connection', listner2); 


Var eventListeners = require('events').EventEmitter.listenerCount(eventEmitter, 'connectio 
console.1og(eventListeners + " 监听 器 监听 连接 事件 。" ) ; 


// 处 理 connection 事件 
eventEmitter.emit('connection'); 


// 移 除 监 绑 定 的 1ijstner1 函数 


eventEmitter.removeListener('connection', listner1); 
console.1og("1Listner1 不 再 受 监 听 。" ) ; 


// 触发 连接 事件 


eventEmitter.emit('connection'); 


eventListeners = require('events').EventEmitter.listenerCount(eventEmitter,'connection'); 
console.1og(eventListeners + " 监听 器 监听 连接 事件 。"); 


console .10g( "程序 执行 完毕 。")， 





以 上 代码 ， 执 行 结果 如 下 所 示 : 


$ node main.js 

2 监听 器 监听 连接 事件 。 

监听 器 listner1 执行 。 
监听 器 Listner2 执行 。 
listner1 不 再 受 监 听 。 

监听 器 Listner2 执行 。 
1 监听 器 监听 连接 事件 。 

程序 执行 完毕 。 


error 事件 


EventEmitter 定义 了 一 个 特殊 的 事件 error， 它 包含 了 错误 的 语义 ， 我 们 在 遇 到 异常 的 时 候 通 
常会 触发 error 事件 。 


当 error 被 触发 时 ，EventEmitter 规定 如 果 没 有 响 应 的 监听 器 ，Node.js 会 把 它 当 作 有 异常 ， 退 
出 程序 并 输出 错误 信息 。 


我 们 一 般 要 为 会 触发 error 事件 的 对 象 设置 监听 器 ， 避 免 遇 到 错误 后 整个 程序 崩溃 。 例 如 : 


var events = require('events'); 
Var emitter = new events.EventEmitter(); 
emitter.emit('error'); 


运行 时 会 显示 以 下 错误 : 


node.js:201 
throw e; // process.nextTick error, or "error' event on first tick 
八 


Error: Uncaught, unspecified 'error' event. 

at EventEmitter.emit (events.js:50:15) 

at Object.<anonymous> (/home/byvoid/error.js:5:9) 
at Module._compile (module.js:441:26) 

at Object..js (module.js:459:10) 

at Module.load (module.js:348:31) 

at Function._load (module.js:308:12) 

at Array.0 (module.js:479:10) 

at EVentEmitter, tickCcallback (node,js:192:40) 


继承 EventEmitter 

大 多 数 时 候 我 们 不 会 直接 使 用 EventEmitter， 而 是 在 对 象 中 继承 它 。 包 括 fs、net、 http 在 内 
的 ， 只 要 是 支持 事件 响应 的 核心 模块 都 是 EventEmitter 的 子 类 。 

为 什么 要 这 样 做 呢 ?原因 有 两 点 : 


首先 ， 具 有 某 个 实体 功能 的 对 象 实现 事件 符合 语义 ， 事件 的 监听 和 发 射 应 该 是 一 个 对 象 的 方 
法 。 


其 次 JavaScript 的 对 象 机 制 是 基于 原型 的 ， 支 持 部 分 多 重 继承 ， 继 承 EventEmitter 不 会 打 乱 
对 象 原 有 的 继承 关系 。 


Node.js Buffer( 缓 冲 区 ) 


JavaScript 语言 自身 只 有 字符 串 数 据 类 型 ， 没 有 二 进 制 数据 类 型 。 


但 在 处 理 像 TCP 流 或 文件 流 时 ， 必 须 使 用 到 二 进 制 数据 。 因 此 在 Nodejs 中 
Buffer 类 ， 该 类 用 来 创建 一 个 专门 存放 二 进 制 数据 的 缓存 区 。 


在 Node.js 中 ，Buffer 类 是 随 Node 内 核 一 起 发 布 的 核心 库 。Buffer 库 为 N 


， 定 义 了 一 个 


ode.js 带 来 了 一 种 


存储 原始 数据 的 方法 ， 可 以 让 Node.js 处理 二 进 制 数据 ， 每 当 需 要 在 Node.js 中 处理 |/O 操 作 
中 移动 的 数据 时 ， 就 有 可 能 使 用 Buffer 库 。 原 始 数据 存储 在 Buffer 类 的 实例 中 。 一 个 Buffer 


类 似 于 一 个 整数 数组 ， 但 它 对 应 于 V8 堆 内 存 之 外 的 一 块 原始 内 存 。 


创建 Buffer 类 

Node Buffer 类 可 以 通过 多 种 方式 来 创建 。 
方法 1 

创建 长 度 为 10 字 节 的 Buffer 实例 : 


var buf = new Buffer(10); 


AAA 


去 2 
通过 给 定 的 数组 创建 Buffer 实例 : 


var buf = new Buffer([10, 20, 30, 40, 50]); 


st 
oS) 


通过 一 个 字符 串 来 创建 Buffer 实例 : 


var buf = new Buffer("www.runoob.com", "utf-8"); 


utf-8 是 默认 的 编码 方式 ， 此 外 它 同样 支持 以 下 编码 : "ascii", "utf8", "utf16le 
"base64" 和 "hex"。 


写 入 缓冲 区 


"UcCs2", 


语法 
写 入 Node 缓冲 区 的 语法 如 下 所 示 : 


buf .write(string[, offset][, length][, encoding]) 


参数 摘 述 如 下 : 
。 string - 写 入 缓冲 区 的 字符 串 。 
。 offset - 缓冲 区 开始 写 入 的 索引 值 ， 黑 认为 0 。 
。 length - 写 入 的 字 节 数 ， 默 认为 bufferlength 


。 encoding - 使 用 的 编码 。 黑 认为 "utf8' 。 


返回 值 


返回 实际 写 入 的 大 小 。 如 果 buffer 空间 不 足 ， 则 只 会 写 人 部 分 字符 串 。 


> 
实例 
buf = new Buffer(256); 
len = buf.write("www.runoob.com"); 


console.10g(" 写 入 字 节 数 : "+ len); 


执行 以 上 代码 ， 输 出 结果 为 : 


$node main.js 
写 入 字 节 数 : 14 


从 缓冲 区 读 取 数据 


语法 
读 取 Node 缓冲 区 数据 的 语法 如 下 所 示 : 


buf.toSstring([encoding][, start][, end]) 


参数 描述 如 下 : 


。 encoding - 使 用 的 编码 。 黑 认为 "utf8' 。 


。 start - 指定 开始 读 取 的 索引 位 置 ， 默 认为 0。 


。 end - 结束 位 置 ， 默 认为 缓冲 区 的 末尾 。 


返回 值 


解码 缓冲 区 数据 并 使 用 指定 的 编码 返回 字符 串 。 


实例 


buf = new Buffer(26); 

for (var i =0 ;i< 26 ; i++) { 
buf[i] = i + 97; 

} 


console.log( buf.toString('ascii')); 
console.log( buf.toString('ascii',0,5)); 
console.log( buf.toString('utf8',0,5)); 
console.1log( buf.toString(undefined,9,5)); 


执行 以 上 代码 ， 输 出 结果 为 : 


$ node main.js 
abcdefghijklmnopqrstuvwxyz 
abcde 

abcde 

abcde 


// 输出 : 
// 输出 : 
// 输出 : 


// 使 用 


将 Buffer 转换 为 JSON 对 象 


语法 


abcdefghijklmnopqrstuvwxyz 
abcde 

abcde 

'utf8' 编码 ， 并 输出 : abcde 


将 Node Buffer 转换 为 JSON 对 象 的 函数 语法 格式 如 下 : 


buf .toJSON() 


返回 值 


返回 JSON 对 象 。 


实例 


var buf = new Buffer('www.runoob.com'); 
var json = buf.toJSON(buf); 


console.1log(json); 


执行 以 上 代码 ， 输 出 结果 为 : 


[ 119, 119, 119, 46, 114, 117, 110, 111, 111, 98, 46, 99, 111, 109 ] 


缓冲 区 合并 
语法 
Node 缓冲 区 合并 的 语法 如 下 所 示 : 


Buffer.concat(list[, totalLength]) 


参数 描述 如 下 : 
elist - 用 于 合并 的 Buffer 对 象 数组 列表 。 


。 totalLength - 指定 合并 后 Buffer 对 象 的 总 长 度 。 


返回 值 


返回 一 个 多 个 成 员 合 并 的 新 Buffer 对 象 。 


中 


实例 


var buffer1 = new Buffer(' 菜 乌 教 程 '); 

var buffer2 = new Buffer('www.runoob.com'); 

var buffer3 = Buffer.concat([buffer1,buffer2]); 
console.1og("buffer3 内 容 : " + buffer3.toString()); 


执行 以 上 代码 ， 输 出 结果 为 : 


buffer3 内 容 : 菜 乌 教 程 www.runoob.com 


缓冲 区 比较 


Node Buffer 比较 的 函数 语法 如 下 所 示 : 


buf .compare(otherBuffer); 


参数 描述 如 下 : 


。 otherBuffer - 与 buf 对 象 比较 的 另外 一 个 Buffer 对 象 。 


返回 值 


返回 一 个 数字 ， 表 示 buf 在 otherBuffer 之 前 ， 之 后 或 相同 。 


中 


实例 


var buffer1 new Buffer('ABC'); 
var buffer2 new Buffer('ABCD'); 
var result = bufferi1.compare(buffer2); 


if(result < 0) { 

console.1og(buffer1 + "在" + buffer2 + "之 前 "); 
}else if(result == 0){ 

console.1og(buffer1 + " 与 " + buffer2 + "相同 "); 
}else { 

console.1og(buffer1 + "在" + buffer2 + "之 后 "); 
} 


执行 以 上 代码 ， 输 出 结果 为 : 


ABC 在 ABCD 之 前 


拷贝 缓冲 区 


语法 
Node 缓冲 区 拷贝 语法 如 下 所 示 : 


buf .copy(targetBuffer[, targetSstart][, sourceStart][, sourceEnd]) 


参数 描述 如 下 : 
。 targetBuffer - 要 拷贝 的 Buffer 对 象 。 
。 targetStart - 数字 , 可 选 , 默认 : 0 
。 sourceStart - 数字 , 可 选 , 默认 : 0 


。 sourceEnd - 数字 , 可 选 , 默认 : buffer.length 


var buffer1 = new Buffer( ' ABC ' ) ; 

// 拷贝 一 个 缓冲 区 

var buffer2 = new Buffer(3); 

bufferi1.copy(buffer2); 

console.log("buffer2 content: " + buffer2.toString()); 


执行 以 上 代码 ， 输 出 结果 为 : 


buffer2 content: ABC 


缓冲 区 裁剪 
Node 缓冲 区 裁剪 语法 如 下 所 示 : 


buf.slice([start][, end]) 


参数 
参数 摘 述 如 下 : 
。 start - 数字 , 可 选 , 默认 : 0 
。 end - 数字 , 可 选 , 默认 : buffer.length 


退回 值 
一 个 新 的 缓冲 区 ， 它 和 旧 缓 冲 区 指向 同一 块 内 存 ， 但 是 从 索引 start 到 end 的 位 置 剪 切 。 


实例 


var buffer1 = new Buffer( ' runoob ' ) ; 

// 剪 切 缓冲 区 

var buffer2 = bufferi1.slice(0,2); 

console.log("buffer2 content: " + buffer2.toString() )， 


执行 以 上 代码 ， 输 出 结果 为 : 


buffer2 content: ru 


缓冲 区 长 度 


语法 
Node 缓冲 区 长 度 计算 语法 如 下 所 示 : 


buf.,length ; 


返回 值 


返回 Buffer 对 象 所 占据 的 内 存 长 度 。 


实例 


var buffer = new Buffer('www.runoob.com'); 
// ”缓冲 区 长 度 
console.log("buffer length: " + buffer.length); 


执行 以 上 代码 ， 输 出 结果 为 : 


buffer length: 14 


方法 参考 手册 


以 下 列 出 了 Node.js Buffer 模块 常用 的 方法 (注意 有 些 方 法 在 旧版 本 是 没有 的 ) 
方法 
Poweuner (slse) 将 会 抛 出 异常 RangeError。 
new Buffer(buffer) 拷贝 参数 buffer 的 数据 到 Buffer 实例 。 


描述 


分 配 一 个 新 的 size 大 小 单位 为 8 位 字 节 的 buffer。 


注意 , sizt 


new Buffer(str[， 
encoding]) 


buf.length 


buf.write(string[, offset][, 
length][, encoding]) 


buf.writeUIntLE(value, 
offset, byteLength[， 
noAssert]) 


buf.writeUIntBE(value, 
offset, byteLength|[， 
noAssert]) 


buf.writelntLE(value， 
offset, byteLength[， 
noAssert]) 


buf.writelntBE(value， 
offset, byteLength|[， 
noAssert]) 


buf.readUIntLE(offset, 
byteLength[, noAssert]) 


buf.readUIntBE(offset, 
byteLength[, noAssert]) 


buf.readIntLE(offset, 
byteLength[, noAssert]) 


buf.readlntBE(offset， 
byteLength[, noAssert]) 


buf.toString([encoding][， 
start][, end]) 


buf.toJSON() 
buf[index] 


buf.equals(otherBuffer) 
buf.compare(otherBuffer) 


buf.copy(targetBuffer[， 
targetStart][, sourceStart] 
[, sourceEnd]) 


buf.slice([start][, end]) 


分 配 一 个 新 的 buffer ， 其 中 包含 着 传人 的 str 字符 串 。 encc 


返回 这 个 buffer 的 bytes 数 。 注 意 这 未 必 是 buffer 里 面 内 容 
分 配 的 内 存 数 ， 它 不 会 随 着 这 个 buffer 对 象 内 容 的 改变 而 改 


根据 参数 offset 偏 移 量 和 指定 的 encoding 编码 方式 ， 将 参 
偏 移 量 默认 值 是 0, encoding 编码 方式 默认 是 utf8。 length 
大 小 。 返回 number 类 型 ， 表 示 写 入 了 多 少 8 位 字 节 流 。 旭 
个 string， 它 将 只 会 只 写 人 部 分 字符 串 。 length 默认 是 buff 
出 现 写 入 部 分 字符 。 


将 value 写 入 到 buffer 里 ， 它 由 offset 和 byteLength 决定 ， 
var b = new Buffer(6); b.writeUINtBE(Ox1234567890ab, 0, 6 


noAssert 值 为 true 时 ， 不 再 验证 value 和 offset 的 有 效 性 。 


将 value 写 入 到 buffer 里 ， 它 由 offset 和 byteLength 决定 ， 
true 时 ， 不 再 验证 value 和 offset 的 有 效 性 。 默认 是 false。 


将 value 写 入 到 buffer 里 ， 它 由 offset 和 byteLength 决定 ， 
true 时 ， 不 再 验证 value 和 offset 的 有 效 性 。 默认 是 false。 


将 value 写 入 到 buffer 里 ， 它 由 offset 和 byteLength 决定 ， 
true 时 ， 不 再 验证 value 和 offset 的 有 效 性 。 默认 是 false。 





支持 读 取 48 位 以 下 的 数字 。noAssert 值 为 true 时 ， offset 
度 ， 默 认为 false。 
支持 读 取 48 位 以 下 的 数字 。noAssert 值 为 true 时 ， offset 
度 ， 默 认为 false。 
支持 读 取 48 位 以 下 的 数字 。noAssert 值 为 true 时 ， offset 
度 ， 默 认为 false。 
支持 读 取 48 位 以 下 的 数字 。noAssert 值 为 true 时 ， offset 


度 ， 默 认为 false。 


根据 encoding 参数 (默认 是 "utf8') 返回 一 个 解码 过 的 strir 
start (默认 是 0) 和 end (默认 是 buffer.length) 作 为 取 值 范围 。 


将 Buffer 实例 转换 为 JSON 对 象 。 


获取 或 设置 指定 的 字 节 。 返 回 值 代表 一 个 字 节 ， 所 以 返回 值 
0xFF 或 者 十 进 制 0 至 255。 


比较 两 个 缓冲 区 是 否 相 等 ， 如 果 是 返回 true， 否 则 返回 fals' 
比较 两 个 Buffer 对 象 ， 返 回 一 个 数字 ， 表 示 buf 在 otherBu 


buffer 拷贝 ， 源 和 目标 可 以 相同 。 targetStart 目标 开始 偏 移 
是 0。 sourceEnd 源 结束 位 置 偏 移 默认 是 源 的 长 度 bufferle 


剪 切 Buffer 对 象 ， 根 据 start( 默 认 是 0 ) 和 end (默认 是 buff 
负 的 索引 是 从 buffer 尾部 开始 计算 的 。 


buf.readUlnt8(offset[， 
noAssert]) 


buf.readUlnt16LE(offset[， 
noAssert]) 


buf.readUlnt16BE(offset[， 
noAssert]) 


buf.readUlnt32LE(offset[， 
noAssert]) 


buf.readUlnt32BE(offset[， 
noAssert]) 


buf.readlnt8(offset[， 
noAssert]) 


buf.readlnt16LE(offset[， 
noAssert]) 


buf.readlnt16BE(offset[， 
noAssert]) 


buf.readlnt32LE(offset[， 
noAssert]) 


buf.readlnt32BE(offset[， 
noAssert]) 


buf.readFloatLE(offset[， 
noAssert]) 


buf.readFloatBE(offset[， 
noAssert]) 


buf.readDoubleLE(offset[， 


noAssert]) 


buf.readDoubleBE(offset[， 


noAssert]) 


buf.writeUlnt8(value， 
offset[, noAssert]) 


根据 指定 的 偏 移 量 ， 读 取 一 个 有 符号 8 位 整数 。 若 参数 noA 
移 量 参数 。 如 果 这 样 offset 可 能 会 超出 buffer 的 末尾 。 默 认 


根据 指定 的 偏 移 量 ， 使 用 特殊 的 endian 字 节 序 格 式 读 取 一 - 
noAssert 为 true 将 不 会 验证 offset 偏 移 量 参数 。 这 意味 着 
默认 是 false。 


根据 指定 的 偏 移 量 ， 使 用 特殊 的 endian 字 节 序 格 式 读 取 一 - 
noAssert 为 true 将 不 会 验证 offset 偏 移 量 参 数 。 这 意味 着 
默认 是 false。 


根据 指定 的 偏 移 量 ， 使 用 指定 的 endian 字 节 序 格 式 读 取 一 - 
noAssert 为 true 将 不 会 验证 offset 偏 移 量 参数 。 这 意味 着 
默认 是 false。 


根据 指定 的 偏 移 量 ， 使 用 指定 的 endian 字 节 序 格 式 读 取 一 - 
noAssert 为 true 将 不 会 验证 offset 偏 移 量 参数 。 这 意味 着 
默认 是 false。 


根据 指定 的 偏 移 量 ， 读 取 一 个 signed 8 位 整数 。 若 参数 no 
偏 移 量 参数 。 这 意味 着 offset 可 能 会 超出 buffer 的 末尾 。 黑 


根据 指定 的 偏 移 量 ， 使 用 特殊 的 endian 格式 读 取 一 个 signe 
为 true 将 不 会 验证 offset 偏 移 量 参数 。 这 意味 着 offset 可 和 有 
false。 


根据 指定 的 偏 移 量 ， 使 用 特殊 的 endian 格式 读 取 一 个 signe 
为 true 将 不 会 验证 offset 偏 移 量 参数 。 这 意味 着 offset 可 和 有 
false。 


根据 指定 的 偏 移 量 ， 使 用 指定 的 endian 字 节 序 格式 污 取 一 < 
noAssert 为 true 将 不 会 验证 offset 偏 移 量 参数 。 这 意味 着 
默认 是 false。 


根据 指定 的 偏 移 量 ， 使 用 指定 的 endian 字 节 序 格 式 读 取 一 - 
noAssert 为 true 将 不 会 验证 offset 偏 移 量 参数 。 这 意味 着 
默认 是 false。 


根据 指定 的 偏 移 量 ， 使 用 指定 的 endian 字 
为 true 将 不 会 验证 offset 偏 移 量 参数 。 这 
false。 


根据 指定 的 偏 移 量 ， 使 用 指定 的 endian 字 节 序 格式 污 取 一 < 
为 true 将 不 会 验证 offset 偏 移 量 参数 。 这 意味 着 offset 可 和 有 
false。 


根据 指定 的 偏 移 量 ， 使 用 指定 的 endian 字 节 序 格式 读 取 一 个 
为 true 将 不 会 验证 offset 偏 移 量 参数 。 这 意味 着 offset 可 和 
false。 


根据 指定 的 偏 移 量 ， 使 用 指定 的 endian 字 节 序 格式 读 取 一 个 
为 true 将 不 会 验证 offset 偏 移 量 参数 。 这 意味 着 offset 可 和 有 
false。 


根据 传 入 的 offset 偏 移 量 将 value 写 入 buffer。 注 意 : value 
数 。 若 参 数 noAssert 为 true 将 不 会 验证 offset 偏 移 量 参数 
者 offset 可 能 会 超出 buffer 的 末尾 从 而 造成 value 被 丢弃 。 


节 序 格式 读 取 一 了 
意味 着 offset 可 


buf.writeUlnt16LE(value， 
offset[, noAssert]) 


buf.writeUInt16BE(value, 
offset[, noAssert]) 


buf.writeUInt32LE(value, 
offset[, noAssert]) 


buf.writeUInt32BE(value, 
offset[, noAssert]) 


buf.writelnt8(value， 
offset[, noAssert]) 


buf.writelnt16LE(value， 
offset[, noAssert]) 


buf.writelnt16BE(value， 
offset[, noAssert]) 


buf.writelnt32LE(value， 
offset[, noAssert]) 


buf.writelnt32BE(value， 
offset[, noAssert]) 


buf.writeFloatLE(value， 
offset[, noAssert]) 


buf.writeFloatBE(value， 
offset[, noAssert]) 


buf.writeDoubleLE(value， 


否则 不 要 使 用 。 默 认 是 false。 


人 offset 偏 移 量 和 指定 的 endian 格式 将 value 写 7 

合法 的 有 符号 16 位 整数 。 若 人 参数 noAssert 为 true 将 不 : 
数 这 意味 着 value 可 能 过 大 ， 或 者 offset 可 能 会 超出 buff 
除非 你 对 这 个 参数 非常 有 把 握 ， 否 则 尽量 不 要 使 用 。 默 认 是 


根据 传人 的 offset 偏 移 量 和 指定 的 endian 格式 将 value 写 7 
个 合法 的 有 符号 16 位 整数 。 若 人 参数 noAssert 为 true 将 不 : 
数 。 这 意味 着 value 可 能 过 大 ， 或 者 offset 可 能 会 超出 buff 
除非 你 对 这 个 参数 非常 有 把 握 ， 否 则 尽量 不 要 使 用 。 默 认 是 


根据 传人 的 offset 偏 移 量 和 指定 的 endian 格式 将 value 写 7 
合法 的 有 符号 32 位 整数 。 若 参 数 noAssert 为 true 将 不 会 ! 
这 意味 着 value 可 能 过 大 ， 或 者 offset 可 能 会 超出 buffer 的 末 上 
对 这 个 参数 非常 有 把 握 ， 否 则 尽量 不 要 使 用 。 黑 认 是 false。 


根据 传人 的 offset 偏 移 量 和 指定 的 endian 格式 将 value 写 7 
合法 的 有 符号 32 位 整数 。 若 参 数 noAssert 为 true 将 不 会 ! 
这 意味 着 value 可 能 过 大 ， 或 者 offset 可 能 会 超出 buffer 的 末 上 
对 这 个 参数 非常 有 把 握 ， 否 则 尽量 不 要 使 用 。 默 认 是 false。 


根据 传人 的 offset 偏 移 量 和 指定 的 endian 格式 将 value 写 7 
个 合法 的 signed 16 位 整数 。 若 参 数 noAssert 为 true 将 不 
数 。 这 意味 着 value 可 能 过 大 ， 或 者 offset 可 能 会 超出 buf 
弃 。 除非 你 对 这 个 参数 非常 有 把 握 ， 否 则 尽量 不 要 使 用 。 蝎 


根据 传人 的 offset 偏 移 量 和 指定 的 endian 格式 将 value 写 7 
个 合法 的 signed 16 位 整数 。 若 参 数 noAssert 为 true 将 不 
数 。 这 意味 着 value 可 能 过 大 ， 或 者 offset 可 能 会 超出 buf 
弃 。 除非 你 对 这 个 参数 非常 有 把 握 ， 否 则 尽量 不 要 使 用 。 蝎 


人 offset 偏 移 量 和 指定 的 endian 格式 将 value 写 7 

合法 的 signed 32 位 整数 。 若 参 数 noAssert 为 true 将 不 
. 这 意味 着 value 可 能 过 大 ， 或 者 offset 可 能 会 超出 buf 
弃 。 除非 你 对 这 个 参数 非常 有 把 握 ， 否 则 尽量 不 要 使 用 。 蝎 


根据 传人 的 offset 偏 移 量 和 指定 的 endian 格式 将 value 写 7 
个 合法 的 signed 32 位 整数 。 若 参 数 noAssert 为 true 将 不 
数 。 这 意味 着 value 可 能 过 大 ， 或 者 offset 可 能 会 超出 buf 
弃 。 除非 你 对 这 个 参数 非常 有 把 握 ， 否 则 尽量 不 要 使 用 。 蝎 


根据 传人 的 offset 偏 移 量 和 指定 的 endian 格式 将 value 写 7 
个 32 位 浮 点 数 类 型 的 值 时 ， 结 果 将 是 不 确定 的 。 若 参 数 nt 
和 offset 偏 移 量 参数 。 这 意味 着 value 可 能 过 大 ， 或 者 offs' 
造成 value 被 丢弃 。 除非 你 对 这 个 参数 非常 有 把 握 ， 否 则 斥 


根据 传人 的 offset 偏 移 量 和 指定 的 endian 格式 将 value 写 7 
个 32 位 浮 点 数 类 型 的 值 时 ， 结 果 将 是 不 确定 的 。 若 参 数 nt 
和 offset 偏 移 量 参数 。 这 意味 着 value 可 能 过 大 ， 或 者 offs' 
造成 value 被 丢弃 。 除非 你 对 这 个 参数 非常 有 把 握 ， 否 则 斥 


根据 传人 的 offset 偏 移 量 和 指定 的 endian 格式 将 value 写 7 
个 有 效 的 64 位 double 类 型 的 值 。 若 参数 noAssert 为 true 


offset[, noAssert]) 


buf.writeDoubleBE(value， 
offset[, noAssert]) 


buf.fill(value[, offset][, 
end]) 


参数 。 这 意味 着 value 可 能 过 大 ， 或 者 offset 可 能 会 超出 b 
弃 。 除非 你 对 这 个 参数 非常 有 把 握 ， 否 则 尽量 不 要 使 用 。 轴 


根据 传人 的 offset 偏 移 量 和 指定 的 endian 格式 将 value 写 7 
个 有 效 的 64 位 double 类 型 的 值 。 若 参 数 noAssert 为 true 
参数 。 这 意味 着 value 可 能 过 大 ， 或 者 offset 可 能 会 超出 b 
弃 。 除非 你 对 这 个 参数 非常 有 把 握 ， 否 则 尽量 不 要 使 用 。 蝎 


使 用 指定 的 value 来 填充 这 个 buffer。 如 果 没 有 指定 offset ( 
buffer.length) ， 将 会 填充 整个 buffer。 


Node.js Stream( 流 ) 
Stream 是 一 个 抽象 接口 ，Node 中 有 很 多 对 象 实 现 了 这 个 接口 。 例 如 ， 对 http 服务 器 发 起 请 
求 的 request 对 象 就 是 一 个 Stream， 还 有 stdout (标准 输出 ) 。 
Node.js，Stream 有 四 种 流 类 型 : 
。 Readable - 可 读 操作 。 
。 Writable - 可 写 操 作 。 
。 Duplex - 可 读 可 写 操 作 . 
。 Transform - 操作 被 写 人 数据 ， 然 后 读 出 结果 。 
所 有 的 Stream 对 象 都 是 EventEmitter 的 实例 。 常 用 的 事件 有 : 
。 data - 当 有 数据 可 读 时 触发 。 
。 end - 没有 更 多 的 数据 可 读 时 触发 。 
。 error - 在 接收 和 写 入 过 程 中 发 生 错误 时 触发 。 
。 finish - 所 有 数据 已 被 写 入 到 底层 系统 时 触发 。 
本 教程 会 为 大 家 介绍 常用 的 流 操 作 。 


从 流 中 读 取 数据 
创建 input.txt 文件 ， 内 容 如 下 : 


菜 乌 教程 官网 地 址 : www.runoob .com 


创建 main.js 文件 , 代码 如 下 : 


var fs = require("fs"),; 
Var data = ''， 


// 创建 可 读 流 
var readerStream = fs.createReadStream( 'Input.txt')， 


// 设置 编码 为 Utf8。 
readerStream.SsetEncoding( 'UTF8 ' ); 


// 处 理 流 事件 --> data，end，and error 
readerSstream.on('data', function(chunk) { 
data += chunk; 


}); 


readerSstream.on('end',function(){ 
console.1log(data); 


}); 


readerSstream.on('error', function(err)t{ 
console.log(err.stack); 


}); 


console .10g( "程序 执行 完毕 ")，; 


以 上 代码 执行 结果 如 下 : 


程序 执行 完毕 
菜 乌 教程 官网 地 址 : www. runoob .com 


创建 main.js 文件 , 代码 如 下 : 


var fs = require("fs"),; 
var data = ' 菜 乌 教 程 官网 地 址 : www, runoob .com'; 


// 创建 一 个 可 以 宇 入 的 流 ， 写 入 到 文件 output .txt 中 
var writerStream = fs.createwriteStream('output.txt'); 


// 使 用 utf8 编码 写 入 数据 
writerStream.write(data, 'UTF8 ' ); 


// 标记 文件 末尾 


writerStream.end() ， 


// 处 理 流 事件 --> data，end，and error 

writerStream.on('finish', function() { 
console.1og(" 写 入 完成 。" ) ; 

}); 


writerStream.on('error', function(err){ 
console.log(err.stack); 


}); 


console.1og(" 程 序 执行 完毕 " ) ; 


以 上 程序 会 将 data 变量 的 数据 写 入 到 output.txt 文件 中 。 代 码 执 行 结果 如 下 : 


$ node main.js 
程序 执行 完毕 
写 入 完成 。 


查看 output.txt 文件 的 内 容 : 


$ cat output.txt 
菜 乌 教程 官网 地 址 : www. runoob .com 


管道 流 


管道 提供 了 一 个 输出 流 到 输入 流 的 机 制 。 通 常 我 们 用 于 从 一 个 流 中 获取 数据 并 将 数据 传递 到 
另外 一 个 流 中 。 


如 上 面 的 图 片 所 示 ， 我 们 把 文件 比 作 装 水 的 桶 ， 而 水 就 是 文件 里 的 内 容 ， 我 们 用 一 根 管子 
(pipe) 连 接 两 个 桶 使 得 水 从 一 个 桶 流入 另 一 个 桶 ， 这 样 就 慢 慢 的 实现 了 大 文件 的 复制 过 程 。 


以 下 实例 我 们 通过 读 取 一 个 文件 内 容 并 将 内 容 写 入 到 另外 一 个 文件 中 。 
设置 input.txt 文件 内 容 如 下 : 


菜 乌 教程 官网 地 址 : www. runoob. com 
人 
管 


鸟 教 和 
道 流 操作 实例 


创建 main.js 文件 , 代码 如 下 : 


var fs = require("fs"),; 


// 创建 一 个 可 读 流 
var readerStream = fs.createReadSstream('input.txt"); 


// 创建 一 个 可 写 流 
var writerStream = fs.createwriteStream( 'output .txt' )， 


// 管道 读 写 操 作 
// 读 取 input.txt 文件 内 容 ， 并 将 内 容 写 入 到 output .txt 文件 中 
readerStream.pipe(writerStream) ; 





console .10g( "程序 执行 完毕 ")， 


代码 执行 结果 如 下 : 


$ node main.js 
程序 执行 完毕 


查看 output.txt 文件 的 内 容 : 


$ cat output.txt 
菜 乌 教程 官网 地 址 : www. runoob .com 
管道 流 操作 实例 


链 式 是 通过 连接 输出 流 到 另外 一 个 流 并 创建 多 个 对 个 流 操 作 链 的 机 制 。 链 式 流 一 般 用 于 管道 
操作 。 


接 下 来 我 们 就 是 用 管道 和 链 式 来 压缩 和 解压 文件 。 
创建 compress.js 文件 , 代码 如 下 : 


var fs = require("fs"); 

var zlib = require('zl1ib'); 

// 压缩 input.txt 文件 为 input .txt.gz 

fs,.createReadStream('input.txt') 
.pipe(zlib.createGzip()) 
.pipe(fs.createwritestream('input.txt.gz')); 


console,1og(" 文 件 压缩 完成 。" ) ; 


代码 执行 结果 如 下 : 


$ node compress.js 
文件 压缩 完成 。 


执行 完 以 上 操作 后 ， 我 们 可 以 看 到 当前 目录 下 生成 了 input.txt 的 压缩 文件 input.txt.gz。 
接 下 来 ， 让 我 们 来 解压 该 文件 ， 创 建 decompress.js 文件 ， 代 码 如 下 : 


var fs = require("fs"),; 

var zlib = require('zl1ib'); 

// 解压 input.txt.gz 文件 为 input .txt 

fs ,createReadStream( "Input,.txt.gz') 
.pipe(zlib.createGunzip( )) 
.pipe(fs.createwriteSstream('input.txt')); 


console .10g( "文件 解压 完成 。"); 


代码 执行 结果 如 下 : 


$ node decompress.js 


文件 解压 完成 。 


Node.js 模 块 系统 


为 了 让 Node.js 的 文件 可 以 相互 调用 ，Node.js 提 供 了 一 个 简单 的 模块 系统 。 


模块 是 Node.js 应 用 程序 的 基本 组 成 部 分 ， 文 件 和 模块 是 一 一 对 应 的 。 换 言 之 ， 一 个 Node.js 
文件 就 是 一 个 模块 ， 这 个 文件 可 能 是 JavaScript 代码 、JSON 或 者 编译 过 的 C/C++ 扩展 。 


创建 模块 
在 Node.js 中 ， 创 建 一 个 模块 非常 简单 ， 如 下 我 们 创建 一 个 ,main.js' 文件 ， 代 码 如 下 : 


var hello = require('./hello'); 
hello.world( ); 


以 上 实例 中 ， 代 码 require('./hello') 引入 了 当前 目录 下 的 hello.js 文 件 (./ 为 当前 目录 ，node.js 
默认 后 级 为 js) 。 


Node.js 提供 了 exports 和 require 两 个 对 象 ， 其 中 exports 是 模块 公开 的 接口 ，require 用 于 
从 外 部 获取 一 个 模块 的 接口 ， 即 所 获取 模块 的 exports 对 象 。 


接 下 来 我 们 就 来 创建 hello.js 文 件 ， 代 码 如 下 : 


exports.world = function() { 
console.log('Hello World'); 


在 以 上 示例 中 ，hello.js 通过 exports 对 象 把 world 作为 模块 的 访 问 接口 ， 在 main.js 中 通过 
require("./hello') 加 载 这 个 模块 ， 然 后 就 可 以 直接 访 问 main.js 中 exports 对 象 的 成 员 男 数 了 。 


有 时 候 我 们 只 是 想 把 一 个 对 象 封装 到 模块 中 ， 格 式 如 下 : 


module.exports = function() { 
AAA 


} 


例如 : 


//hello.js 
function Hello() { 
varname; 
this,.setName = function(thyName) { 
name = thyName; 


}; 
this,.sayHello = function() { 
console.log('Hello ' + name); 


module.exports = Hello; 


这 样 就 可 以 直接 获得 这 个 对 象 了 : 


//main.js 

var Hello = require('./hello'); 
hello = new Hello(); 
hello.setName('BYVoid'); 
hello.sayHello( ); 


模块 接口 的 唯一 变化 是 使 用 module.exports = Hello 代替 了 exports.world = function() 们 。 在 
外 部 引用 该 模块 时 ， 其 接口 对 象 就 是 要 输出 的 Hello 对 象 本 身 ， 而 不 是 原先 的 exports。 

服务 端的 模块 放 在 哪里 

也 许 你 已 经 注意 到 ， 我 们 已 经 在 代码 中 使 用 了 模块 了 。 像 这 样 : 


var http = require("http"); 


http.createServer(...); 
Node.js 中 自 带 了 一 个 叫做 "http" 的 模块 ， 我 们 在 我 们 的 代码 中 请 求 它 并 把 返回 值 赋 给 一 个 本 地 
变量 。 
这 把 我 们 的 本 地 变量 变 成 了 一 个 拥有 所 有 http 模块 所 提供 的 公共 方法 的 对 象 。 
Node.js 的 require 方 法 中 的 文件 查找 策略 如 下 : 


由 于 Node.js 中 存在 4 类 模块 (原生 模块 和 3 种 文件 模块 ) ， 尽 管 require 方 法 极其 简单 ， 但 是 内 
部 的 加 载 却 是 十 分 复杂 的 ， 其 加 载 优 先 级 也 各 自 不 同 。 如 下 图 所 示 : 


从 文件 模块 缓存 中 加 载 


尽管 原生 模块 与 文件 模块 的 优先 级 不 同 ， 但 是 都 不 会 优先 于 从 文件 模块 的 缓存 中 加 载 已 经 存 
在 的 模块 。 


从 原生 模块 加 载 


原生 模块 的 优先 级 仅 次 于 文件 模块 缓存 的 优先 级 。require 方 法 在 解析 文件 名 之 后 ， 优 先 检 查 
模块 是 否 在 原生 模块 列表 中 。 以 http 模 块 为 例 ， 尽 管 在 目录 下 存在 一 个 
http/http.js/http.node/http.json 文 件 ，require("http") 都 不 会 从 这 些 文 件 中 加 载 ， 而 是 从 原生 模 
块 中 加 载 。 


原生 模块 也 有 一 个 缓存 区 ， 同 样 也 是 优先 从 缓存 区 加 载 。 如 果 缓 存 区 没有 被 加 载 过 ， 则 调用 
原生 模块 的 加 载 方式 进行 加 载 和 执行 。 


从 文件 加 载 


当 文 件 模块 缓存 中 不 存在 ， 而 且 不 是 原生 模块 的 时 候 ， Se a ridbe 
数 ， 并 从 文件 系统 中 加 载 实 际 的 文件 ， 加 载 过 程 中 的 包装 和 编译 细节 在 前 一 节 中 已 经 介 
过 ， 这 里 我 们 将 详细 描述 查找 文件 模块 的 过 程 ， 其 中 ， 也 有 一 些 细节 值得 知晓 。 


require 方 法 接受 以 下 几 种 参数 的 传递 : 


。 http、fs、path 等 ， 原 生 模 块 。 

。 ./mod 或 /mod， 相 对 路 径 的 文件 模块 。 

。 /pathtomodule/mod， 绝 对 路 径 的 文件 模块 。 
。 mod， 非 原生 模块 的 文件 模块 。 


Node.js 函数 

在 JavaScript 中 ， 一 个 函数 可 以 作为 另 一 个 图 数 接收 一 个 参数 。 我 们 可 以 先 定义 一 个 男 数 ， 然 
后 传递 ， 也 可 以 在 传递 参数 的 地 方 直 接 定义 画 数 。 

Node.js 中 画 数 的 使 用 与 Javascript 类 似 ， 举 例 来 说 ， 你 可 以 这 样 做 : 


function say(word) { 
console.1log(word); 


function execute(someFunction, value) { 
someFunction(value); 


} 


execute(say, "Hello"); 
以 上 代码 中 ， 我 们 把 say 函数 作为 execute 函 数 的 第 一 个 变量 进行 了 传递 。 这 里 返回 的 不 是 


say 的 返回 值 ， 而 是 say 本 身 ! 


这 样 一 来 ， say 就 变 成 了 execute 中 的 本 地 变量 someFunction ，execute 可 以 通过 调用 
someFunction() 〈 带 括号 的 形式 ) 来 使 用 say 本 数 。 


当然 ， 因 为 say 有 一 个 变量 ， execute 在 调用 someFunction 时 可 以 传递 这 样 一 个 变量 。 


匿名 函数 


我 们 可 以 把 一 个 函数 作为 变量 传递 。 但 是 我 们 不 一 定 要 绕 这 个 " 先 定 义 ， 再 传递 "的 圈子 ， 我 们 
可 以 直接 在 另 一 个 函数 的 括号 中 定义 和 传递 这 个 图 数 : 


function execute(someFunction, value) { 
someFunction(value); 


} 


execute(function(word){ console.log(word) }, "Hello"); 


我 们 在 execute 接受 第 一 个 参数 的 地 方 直 接 定义 了 我 们 准 各 传递 给 execute 的 函数 。 
用 这 种 方式 ， 我 们 其 至 不 用 给 这 个 函数 起 名 字 ， 这 也 是 为 什么 它 被 叫做 匿名 男 数 。 


范 数 传递 是 如 何 让 HTTP 服 务 器 工作 的 


着 这 些 知识 ， 我 们 再 来 看 看 我 们 简约 而 不 简单 的 HTTP 服 务 器 : 


都 


var http = require("http"); 


http.createServer(function(request, response) { 
response.writeHead(200, {"Content-Type": "text/plain"}); 
response.write("Hello World"); 
response.end(); 

}).listen(8888); 


现在 它 看 上 去 应 该 清晰 了 很 多 : 我 们 向 createServer 辑 数 传递 了 一 个 匿名 回 数 。 


用 这 样 的 代码 也 可 以 达到 同样 的 目的 : 


var http = require("http"); 


function onRequest(request, response) { 
response.writeHead(200, {"Content-Type": "text/plain"}); 
response.write("Hello World"); 
response.end( ); 


} 


http.createServer(onRequest).1listen(8888); 


Node.js 路 由 


我 们 要 为 路 由 提供 请 求 的 URL 和 其 他 需要 的 GET 及 POST 参数 ， 随 后 路 由 需要 根据 这 些 数据 来 
执行 相应 的 代码 。 


因此 ， 我 们 需要 查看 HTTP 请 求 ， 从 中 提取 出 请 求 的 URL 以 及 GET/POST 参 数 。 这 一 功能 应 当 
属于 路 由 还 是 服务 器 〈 甚 至 作为 一 个 模块 自身 的 功能 ) 确实 值得 探讨 ， 但 这 里 暂 定 其 为 我 们 
的 HTTP 服 务 器 的 功能 。 


我 们 需要 的 所 有 数据 都 会 包含 在 request 对 象 中 ， 该 对 象 作 为 onRequest() 回 调 函 数 的 第 一 个 参 
数 传递 。 但 是 为 了 解析 这 些 数据 ， 我 们 需要 额外 的 Node.JS 模 块 ， 它 们 分 别 是 url 和 querystring 
模块 。 


url.parse(string).query 


url.parse(string).pathname 


| 
querystring(string)["foo"] 


querystring(string)["hello"] 


当然 我 们 也 可 以 用 querystring 模 块 来 解析 POST 请 求 体 中 的 参数 ， 稍 后 会 有 演示 。 


现在 我 们 来 给 onRequest() 画 数 加 上 一 些 逻 辑 ， 用 来 找 出 浏览 器 请 求 的 URL 路 径 : 


var http = require("http"); 
var Url = require("url"); 


function start() { 
function onRequest(request, response) { 
var pathname = url.parse(request.url).pathname; 
console.log("Request for " + pathname + " received."); 
response.writeHead(200, {"Content-Type": "text/plain"}); 
response.write("Hello World"); 
response.end(); 


} 


http.createServer(onRequest).1listen(8888); 
console.log("Server has started."); 


} 


exports.start = start,; 


好 了 ， 我 们 的 应 用 现在 可 以 通过 请 求 的 URL 路 径 来 区 别 不 同 请 求 了 -- 这 使 我 们 得 以 使 用 路 由 
(还 未 完成 ) 来 籽 请 求 以 URL 路 径 为 基准 映射 到 处 理 程序 上 。 


在 我 们 所 要 构建 的 应 用 中 ， 这 意味 着 来 自 /start 和 和 /upload 的 请 求 可 以 使 用 不 同 的 代码 来 处 理 。 
稍 后 我 们 将 看 到 这 些 内 容 是 如 何 整合 到 一 起 的 。 


现在 我 们 可 以 来 编写 路 由 了 ， 建 立 一 个 名 为 router.js 的 文件 ， 添 加 以 下 内 容 : 


function route(pathname) { 
console.log("About to route a request for " + pathname); 


} 


exports.route = route,; 


如 你 所 见 ， 这 段 代 码 什么 也 没 干 ， 不 过 对 于 现在 来 说 这 是 应 该 的 。 在 添加 更 多 的 逻辑 以 前 ， 
我 们 先 来 看 看 如 何 把 路 由 和 服务 器 整合 起 来 。 


我 们 的 服务 器 应 当知 道路 由 的 存在 并 加 以 有 效 利用 。 我 们 当然 可 以 通过 硬 编码 的 方式 将 这 一 
依赖 项 绑 定 到 服务 器 上 ， 但 是 其 它 语言 的 编程 经 验 告诉 我 们 这 会 是 一 件 非 常 痛苦 的 事 ， 因 此 
我 们 将 使 用 依赖 注入 的 方式 较 松 散 地 添加 路 由 模块 。 


首先 ， 我 们 来 扩展 一 下 服务 器 的 start() 画 数 ， 以 便 将 路 由 画 数 作 为 参数 传递 过 去 : 


var http = require("http"); 
var Url = require("url"); 


function start(route) { 
function onRequest(request, response) { 
var pathname = url.parse(request.url).pathname; 
console.log("Request for " + pathname + " received."); 


route(pathname); 
response.writeHead(200, {"Content-Type": "text/plain"}); 
response.write("Hello World"); 


response.end(); 


} 


http.createServer(onRequest).1listen(8888); 
console.log("Server has started."); 


} 


exports.start = start,; 


同时 ， 我 们 会 相应 扩展 index.js， 使 得 路 由 男 数 可 以 被 注入 到 服务 器 中 : 


var server 
var router 


require("./server"); 
require("./router"); 


server.start(router.route); 


在 这 里 ， 我 们 传递 的 函数 依旧 什么 也 没 做 。 


如 果 现 在 启动 应 用 (node index.js， 始 终 记得 这 个 命令 行 ) ， 随 后 请 求 一 个 URL， 你 将 会 看 到 
应 用 输出 相应 的 信息 ， 这 表明 我 们 的 HTTP 服 务 器 已 经 在 使 用 路 由 模块 了 ， 并 会 将 请 求 的 路 径 
传递 给 路 由 : 


bash$ node index.js 
Request for /foo received. 
About to route a request for /foo 


以 上 输出 已 经 去 掉 了 比较 烦人 的 /favicon.ico 请 求 相 关 的 部 分 。 


Node.js 全 局 对 象 
JavaScript 中 有 一 个 特殊 的 对 象 ， 称 为 全 局 对 象 《Global Object) ， 它 及 其 所 有 属性 都 可 以 
在 程序 的 任何 地 方 访 问 ， 即 全 局 变量 。 


在 浏览 器 JavaScript 中 ， 通 常 window 是 全 局 对 象 ， 而 Node.js 中 的 全 局 对 象 是 global， 所 有 
全 局 变量 (除了 global 本 身 以 外 ) 都 是 global 对 象 的 属性 。 


我 们 在 Node.js 中 能 够 直接 访问 到 对 象 通常 都 是 global 的 属性 ， 如 console、process 等 ， 下 
面 逐 一 介绍 。 


全 局 对 象 与 全 局 变量 


global 最 根本 的 作用 是 作为 全 局 变量 的 宿主 。 按 照 ECMAScript 的 定义 ， 满 足以 下 条 件 的 变 
量 是 全 局 变量 : 

。 在 最 外 层 定 义 的 变量 ; 

。 全 局 对 象 的 属性 ; 

。 隐 式 定义 的 变量 (未 定义 直接 赋值 的 变量 ) 。 


当 你 定义 一 个 全 局 变量 时 ， 这 个 变量 同时 也 会 成 为 全 局 对 象 的 属性 ， 反 之 亦 然 。 需 要 注 意 的 
是 ， 在 Node.js 中 你 不 可 能 在 最 外 层 定 义 变 量 ， 因 为 所 有 用 户 代码 都 是 属于 当前 模块 的 ， 而 
模块 本 身 不 是 最 外 层 上 下 文 。 

注意 : 永远 使 用 var 定义 变量 以 避免 引入 全 局 变量 ， 因 为 全 局 变量 会 污染 命名 空间 ， 提 高 代 
码 的 耦合 风险 。 


process 


process 是 一 个 全 局 变量 ， 即 global 对 象 的 属性 。 

它 用 于 描述 当前 Node.js 进程 状态 的 对 象 ， 提 供 了 一 个 与 操作 系统 的 简单 接口 。 通 常 在 你 写 
本 地 命令 行程 序 的 时 候 ， 少 不 了 要 和 它 打 交道 。 下 面 将 会 介绍 process 对 象 的 一 些 最 常用 的 
成 员 方 法 。 


process.argv 是 命令 行 参 数 数 组 ， 第 一 个 元 素 是 node， 第 二 个 元 素 是 脚本 文件 名 ， 从 第 三 个 
元 素 开始 每 个 元 素 是 一 个 运行 参数 。 


console.log(process.argv); 


将 以 上 代码 存储 为 argvjs， 通 过 以 下 命令 运行 : 


$ node argv,js 1991 name=byvoid --v "Carbo Kuo" 
[ "node '， 

'/home/byvoid/argv.js', 

'1991', 

"name=byvoid '， 

SA 

"Carbo Kuo' ] 


。 process.stdout 是 标准 输出 流 ， 通 常 我 们 使 用 的 console.log() 向 标准 输出 打印 字符 ， 而 
process.stdout.write() 函数 提供 了 更 底层 的 接口 。 

。 process.stdin 是 标准 输入 流 ， 初 始 时 它 是 被 上 暂停 的 ， 要 想 从 标准 输入 读 取 数据 ， 你 必须 
恢复 流 ， 并 手动 编写 流 的 事件 响应 画 数 。 


process.stdin.resume(); 
process.stdin.on('data', function(data) { 
process,.stdout.write('read from console: ' + data.toSstring()); 


yy 


。 process.nextTick(callback) 的 功能 是 为 事件 循环 设置 一 项 任务 ，Node.js 会 在 下 次 事件 
循环 调 响 应 时 调用 callback。 


初学 者 很 可 能 不 理解 这 个 函数 的 作用 ， 有 什么 任务 不 能 在 当下 执行 完 ， 需 要 交 给 下 次 事 件 循 
环 响 应 来 做 呢 ? 


我 们 讨论 过 ，Node.js 适合 I/O 密集 型 的 应 用 ， 而 不 是 计算 密集 型 的 应 用 ， 因为 一 个 Node.js 
进程 只 有 一 个 线程 ， 因 此 在 任何 时 刻 都 只 有 一 个 事件 在 执行 。 


如 果 这 个 事 件 占用 大 量 的 CPU 时 间 ， 执 行事 件 循环 中 的 下 一 个 事件 就 需要 等 竺 很久， 因此 
Node.js 的 一 个 编程 原则 就 是 尽量 缩短 每 个 事件 的 执行 时 间 。process.nextTick() 提供 了 一 个 
这 样 的 工具 ， 可 以 把 复杂 的 工作 拆散 ， 变 成 一 个 个 较 小 的 事件 。 


functiondoSomething(args, callback) { 
somethingComplicated(args); 
callback( ); 


doSomething(functiononEnd() { 
compute( ); 


}); 


我 们 假设 compute() 和 somethingComplicated() 是 两 个 较为 耗 时 的 函数 ， 以 上 的 程序 在 调用 
doSomething() 时 会 先 执行 somethingComplicated()， 然 后 立即 调用 回调 玉 数 ， 在 onEnd() 
中 又 会 执行 compute()。 下 面 用 process.nextTick() 改 宇 上 面 的 程序 : 


functiondoSomething(args, callback) { 
somethingComplicated(args); 
process.nextTick(callback); 


doSomething(functiononEnd() { 
compute( ); 


}); 


改写 后 的 程序 会 把 上 面 耗 时 的 操作 拆 分 为 两 个 事件 ， 减 少 每 个 事件 的 执行 时 间 ， 提 高 事 件 响 


注意 : 不 要 使 用 setTimeout(fn,0) 代 蔡 process.nextTick(callback)， 前 者 比 后 者 效率 要 低 得 


我 们 探讨 了 process 对 象 常用 的 几 个 成 员 ， 除 此 之 外 process 还 展示 了 process.platform、 
process.pid、process.execPath、process.memoryUsage() 等 方法 ， 以 及 POSIX 进程 信号 响 
应 机 制 。 有 兴趣 的 读者 可 以 访问 http://nodejs.org/api/process.html 了 解 详细 内 容 。 


console 
console 用 于 提供 控制 台 标 准 输 出 ， 它 是 由 Internet Explorer 的 JScript 引擎 提供 的 调试 工 
具 ， 后 来 逐渐 成 为 浏览 器 的 事实 标准 。 


Node.js 治 用 了 这 个 标准 ， 提 供与 习惯 行为 一 致 的 console 对 象 ， 用 于 向 标准 输出 流 
(stdout) 或 标准 错误 流 (stderr) 输出 字符 。 ? console.log() : 向 标准 输出 流 打 印字 符 并 以 
换行 符 结 


console.log 接受 若干 个 参数 ， 如 果 只 有 一 个 参数 ， 则 输出 这 个 参数 的 字符 串 形 式 。 如 果 有 多 
个 参数 ， 则 以 类 似 于 C 语言 printf() 命令 的 格式 输出 。 


第 一 个 参数 是 一 个 字符 种， 如 果 没 有 参数 ， 只 打印 一 个 换行 。 


console.1log('Hello world'); 
console.1log( 'byvoid%diovyb"' ) ; 
console.1log('byvoid%diovyb', 1991); 


运行 结果 为 : 


Hello world 
byvoid%diovyb 
byvoid1991iovyb 


。 console.error() : 与 console.log() 用 法 相同 ， 只 是 向 标准 错误 流 输 出 。 
。 console.trace() : 向 标准 错误 流 输 出 当前 的 调用 栈 。 


console.trace(); 


运行 结果 为 : 


Trace : 


at 
at 
at 
at 
at 
at 
at 


Object.<anonymous> (/home/byvoid/consoletrace.js:1:71) 
Module._compile (module.js:441:26) 

Object. .js (module.js:459:10) 

Module, load (module.js:348:31) 

Function._ load (module.js:308:12) 

Array.0 (module.js:479:10) 

EventEmitter._ tickCallback (node.js:192:40) 


Node.js 党 用 工具 util 


util 是 一 个 Node.js 核心 模块 ， 提 供 常 用 函数 的 集合 ， 用 于 弥补 核心 JavaScript 的 功能 过 于 精 
简 的 不 足 。 


util.inherits 


util.inherits(constructor, superConstructor) 是 一 个 实现 对 象 间 原 型 继承 的 函数 。 


JavaScript 的 面向 对 象 特性 是 基于 原型 的 ， 与 常见 的 基于 类 的 不 同 。JavaScript 没有 提供 对 
象 继 承 的 语言 级 别 特性 ， 而 是 通过 原型 复制 来 实现 的 。 


在 这 里 我 们 只 介绍 utilinherits 的 用 法 ， 示 例如 下 : 


varutil = require('util'); 
functionBase() { 
this.name = 'base'; 
this.base = 1991; 
this,.sayHello = function() { 
console.log('Hello ' + this.name); 


}; 
} 


Base.prototype.showName = function() { 
console.1log(this.name); 
}; 


functionSub() { 
this.name = 'sub'; 


util.inherits(Sub, Base); 
varobjBase = newBase(); 
objBase. showName( ); 
objBase. sayHello( ); 
console.1log(objBase); 
varobjSub = newSub(); 
objSub. showName( ); 
//objSub.sayHello( ); 
console.1log(objSub); 


我 们 定义 了 一 个 基础 对 象 Base i 的 Sub，Base 有 三 个 在 构造 男 数 内 定义 的 
属性 和 一 个 原型 中 定义 的 函数 ， 通 过 util.inherits 实现 继承 。 运 行 结果 如 下 : 


base 

Hello base 

{ name: 'base', base: 1991, sayHello: [Function] } 
sub 


{ name: 'sub' } 


注意 : Sub 仅仅 继承 了 Base 在 原型 中 定义 的 函数 ， 而 构造 画 数 内 部 创造 的 base 属 性 和 
sayHello 画 数 都 没有 被 Sub 继承 。 


同时 ， 在 原型 中 定义 的 属性 不 会 被 console.log 作 为 对 象 的 属性 输出 。 如 果 我 们 去 掉 
objSub.sayHello(); 这 行 的 注释 ， 将 会 看 到 : 


node.js:201 
throw e; // process.nextTick error, or ‘error' event on first tick 
八 


TypeError: Object #<Sub> has no method 'sayHello' 

at Object.<anonymous> (/home/byvoid/utilinherits.js:29:8) 
at Module._ compile (module.js:441:26) 

at Object..js (module.js:459:10) 

at Module.load (module.js:348:31) 

at Function._load (module.js:308:12) 

at Array.0 (module.js:479:10) 

at EVentEmitter, tickCallback (node,js:192:40) 


util.inspect 


util.inspect(object,[showHidden],[depth],[colors]) 是 一 个 将 任意 对 象 转换 为 字符 串 的 方法 ， 通 
常用 于 调试 和 错误 输出 。 它 至 少 接受 一 个 参数 object， 即 要 转换 的 对 象 。 


showHidden 是 一 个 可 选 参 数 ， 如 果 值 为 true， 将 会 输出 更 多 隐藏 信息 。 


depth 表示 最 大 递归 的 层 数 ， 如 果 对 象 很 复 厅 ， 你 可 以 指定 层 数 以 控制 输出 信息 的 多 少 。 如 
果 不 指定 depth， 0 ， 指 定 为 null 表示 将 不 限 递 为 层 数 完整 通 历 对 象 。 如 果 color 
值 为 true， PoE ANS 颜色 编码 ， 通 常用 于 在 终端 显示 更 漂亮 的 效果 。 


特别 要 指出 的 是 ，util.inspect 并 不 会 简单 地 直接 把 对 象 转 换 为 字符 串 ， 即 使 该 对 象 定义 了 
toString 方法 也 不 会 调用 。 


varutil = require('util'); 
functionPerson() { 
this.name = 'byvoid'; 
this,toString = function() { 
return this.name; 


}; 
} 


varobj = newPerson(); 
console.1log(util.inspect(obj)); 
console.log(util.inspect(obj, true)); 


运行 结果 是 : 


{ name: 'byvoid', toString: [Function] } 

{ toString: 

{ [Function] 

[prototype]: { [constructor]: [Circular] }, 
[caller]: null, 

[length]: 0 

[nameJ]: 7 

[arguments]: null }, 

name: 'byvoid' } 


util.isArray(object) 


如 果 给 定 的 参数 "object" 是 一 个 数组 返回 true， 否 则 返回 false。 


var util = require( util ' ); 


util.isArray([]) 

// true 
util.isArray(new Array) 

// true 
util.isArray({}) 

// false 


util.isRegExp(object) 
如 果 给 定 的 参数 "object" 是 一 个 正则 表达 式 返回 true， 否 则 返回 false。 


var util = require('util'); 


util.isRegExp(/some regexp/) 
EuUe 

util.isRegExp(new RegExp(' another regexp')) 
// true 

util.isRegExp({}) 
// false 


util.isDate(object) 


如 果 给 定 的 参数 "object" 是 一 个 日 期 返回 true， 否 则 返回 false。 


var util = require( util ' ); 


util.isDate(new Date()) 

A/ true 
util.isDate(Date()) 

// false (without 'new' returns a String) 
util.isDate({}) 

// false 


util.isError(object) 


如 果 给 定 的 参数 "object" 是 一 个 错误 对 象 返 回 true， 否 则 返回 false。 


var util = require('util'); 


util.isError(new Error()) 


// true 

util.isError(new TypeError()) 
// true 

util.isError({ name: 'Error', message: 'an error occurred' }) 
// false 


更 多 详情 可 以 访问 http://nodejs.org/api/util.html 了 解 详 细 内 容 。 


Node.js 文件 系统 


Node.js 提供 一 组 类 似 UNIX (POSIX) 标准 的 文件 操作 API。 Node 导入 文件 系统 模块 (fs) 语 
法 如 下 所 示 : 


var fs = require("fs") 


异步 和 同步 


Node.js 文件 系统 (fs 模块 ) 模块 中 的 方法 均 有 异步 和 同步 版 本 ， 例 如 读 取 文件 内 容 的 画 数 有 
异步 的 fs.readFile() 和 同步 的 fs.readFileSync()。 


异步 的 方法 函数 最 后 一 个 参数 为 回调 范 数 ， 回 调 函 数 的 第 一 个 参数 包含 了 错误 信息 (error)。 
建议 大 家 是 用 异步 方法 ， 比 起 同步 ， 异 步 方 法 性 能 更 高 ， 速 度 更 快 ， 而 且 没有 阻塞 。 


实例 
创建 input.txt 文件 ， 内 容 如 下 : 


菜 乌 教程 官网 地 址 : www.runoob .com 
文件 读 取 实例 


创建 file.js 文件 , 代码 如 下 : 


var fs = require("fs"),; 


// 异步 读 取 
fs.readFile('input.txt', function (err, data) { 
(Ce 
return console.error(err); 


console .10g(" 异 步 读 取 : " + data.toSstring()); 
}); 
// 同步 读 取 
var data = fs.readFileSync('input.txt'); 
console.1og(" 同 步 读 取 : " + data.tostring()); 


一 


console .10g( "程序 执行 完毕 。")， 


以 上 代码 执行 结果 如 下 : 


$ node file.js 
同步 读 取 : 菜 乌 教程 官网 地 址 : www. runoob .com 
文件 读 取 实例 


程序 执行 完毕 。 
异步 读 取 : 菜 乌 教程 官网 地 址 : www. runoob .com 
文件 读 取 实例 


接 下 来 ， 让 我 们 来 具体 了 解 下 Node.js 文件 系统 的 方法 。 


打开 文件 


语法 
以 下 为 在 异步 模式 下 打开 文件 的 语法 格式 : 


fs.open(path, flags[, mode], callback) 


参数 
参数 使 用 说 明 如 下 : 
。 path - 文件 的 路 径 。 


。 flags - 文件 打开 的 行为 。 具 体 值 详 见 下 文 。 
。 mode - 设置 文件 模式 (权限 )， 文 件 创建 默认 权限 为 0666( 可 读 ， 可 写 )。 
。 callback - 回调 本 数 ， 带 有 两 个 参数 如 : callback(err, fd)。 


flags 参数 可 以 是 以 下 值 : 


Flag 描述 


r 以 读 取 模式 打开 文件 。 如 果 文 件 不 存在 抛 出 异常 。 

r+ 以 读 写 模式 打开 文件 。 如 果 文 件 不 存在 抛 出 异常 。 

rs 以 同步 的 方式 读 取 文 件 。 

rs+ 以 同步 的 方式 读 取 和 写 和 文件。 

Ww 以 写 入 模式 打开 文件 ， 如 果 文 件 不 存在 则 创建 。 

WX 类 似 'w'， 但 是 如 果 文 件 路 径 不 存在 ， 则 文件 写 入 失败 。 
W+ 以 读 写 模式 打开 文件 ， 如 果 文 件 不 存在 则 创建 。 

WX+ 类 似 ' w+'， 但 是 如 果 文 件 路 径 不 存在 ， 则 文件 读 写 失败 。 
a 以 追加 模式 打开 文件 ， 如 果 文 件 不 存在 则 创建 。 

ax 类 似 'a'， 但 是 如 果 文 件 路 径 不 存在 ， 则 文件 追加 失败 。 
at 以 读 取 追加 模式 打开 文件 ， 如 果 文 件 不 存在 则 创建 。 


aX+ 类 似 'a+'， 但 是 如 果 文 件 路 径 不 存在 ， 则 文件 读 取 追 加 失败 。 


实例 
接 下 来 我 们 创建 flejs 文件 ， 并 打开 input.txt 文件 进行 读 写 ， 代 码 如 下 所 示 : 


var fs = require("fs"),; 
// 异步 打开 文件 
console.10g(" 准 各 打开 文件 1 "); 
fs.,open('input.txt', 'r+', function(err, fd) { 
sh (en 
return console.error(err); 


} 
console.1o0g( "文件 打开 成 功 ! "); 
}); 


以 上 代码 执行 结果 如 下 : 


$ node file.js 
准备 打开 文件 ! 
文件 打开 成 功 ! 


获取 文件 信息 


语法 


以 下 为 通过 异步 模式 获取 文件 信息 的 语法 格式 : 


fs,stat(path，callback ) 


参数 使 用 说 明 如 下 : 
。 path - 文件 路 径 。 
。 callback - 回调 本 数 ， 带 有 两 个 参数 如 : (err, stats), stats 是 fs.Stats 对 象 。 


fs.stat(path) 执 行 后 ， 会 将 stats 类 的 实例 返回 给 其 回调 函数 。 可 以 通过 stats 类 中 的 提供 方法 判 
断 文 件 的 相关 属性 。 例 如 判断 是 否 为 文件 : 


var fs = require('fs')， 


fs.stat('/Users/liuht/code/itbilu/demo/fs.js', function (err, stats) { 


console.log(stats.isFile()); //true 
}) 
stats 类 中 的 方法 有 : 
方法 描述 
stats.isFile() 如 果 是 文件 返回 true， 否 则 返回 false。 
stats.isDirectory() 如 果 是 目录 返回 true， 否 则 返回 false。 
stats.isBlockDevice() 如 果 是 块 设备 返回 true， 否 则 返回 false。 


stats.isCharacterDevice() ” 如果 是 字符 设备 返回 true， 否 则 返回 false。 


stats.isSymbolicLink() 如 果 是 软 链接 返回 true， 否 则 返回 false。 
. 如 果 是 FIFO， 返 回 true， 否 则 返回 false。FIFO 是 UNIX 中 的 
ee 一 种 特殊 类 型 的 命 全 管道 。 
stats.isSocket() 如 果 是 Socket 返回 true， 否 则 返回 false。 
实例 
头 


接 下 来 我 们 创建 file.js 文件 ， 代 码 如 下 所 示 : 


var fs = require("fs"),; 


console.1og(" 准 备 打开 文件 1 ") 
fs,Sstat('input.txt'，Tfunction (err, stats) { 
CGIRTN 
return console.error(err); 
} 


console.log(stats); 
console .1l0g(" 读 取 文 件 信 息 成 功 ! "); 


// 检测 文件 类 型 
console .10g( "是 否 为 文件 (isFile) ? " + stats.isFile()); 
console .10g( "是否 为 目录 (isDirectory) ? " + stats.isDirectory()); 


}); 





以 上 代码 执行 结果 如 下 : 


$ node file.js 
准备 打开 文件 ! 
{ dev: 16777220, 
mode: 33188, 
nlink: 1, 
uid: 501, 
gid: 20, 
rdev: 0, 
blksize: 4096, 
ino: 40333161, 
size: 61, 
blocks: 8, 
atime: Mon Sep 07 2015 17:43:55 GMT+0800 (CST), 
mtime: Mon Sep 07 2015 17:22:35 GMT+0800 (CST), 
ctime: Mon Sep 07 2015 17:22:35 GMT+0800 (CST) } 
读 取 文 件 信息 成 功 ! 
是 否 为 文件 (isFile) ? true 
是 否 为 目录 (isDirectory) ? false 


ss 

写 人 文件 

语法 

以 下 为 异步 模式 下 写 入 文件 的 语法 格式 : 
fs.writeFile(filename, data[, options], callback) 


如 果 文 件 存 在 ， 该 方法 写 和 人 的 内 容 会 覆盖 旧 的 文件 内 容 。 


参数 
参数 使 用 说 明 如 下 : 
。 path - 文件 路 径 。 
。 data - 要 写 入 文件 的 数据 ， 可 以 是 String( 字 符 串 ) 或 Buffer( 流 ) 对 象 。 


。 options - 该 参数 是 一 个 对 象 ， 包 含 {encoding, mode, flag}。 默 认 编 码 为 utf8, 模式 为 
0666 ， flag 为 'W' 


。 callback - 回调 琅 数 ， 回 调 图 数 只 包含 错误 信息 参数 (err)， 在 写 入 失败 时 返回 。 


实例 
接 下 来 我 们 创建 file.js 文件 ， 代 码 如 下 所 示 : 


var fs = require("fs"),; 


console.1og(" 准 备 写 入 文件 ") ; 
fs.writeFile('input.txt'， 我 是 通过 写 入 的 文件 内 容 ! '， function(err) { 
if (err) { 
return console.error(err); 


} 
console .10g( "数据 写 入 成 功 ! "); 
console.1og("-------- 我 是 分 割 线 ------------- 0 ) 
console .10g(" 读 取 写 入 的 数据 ! " ); 
fs.readFile('input.txt', function (err, data) { 
at Cle 
return console.error(err); 


} 

console.10g(" 异 步 读 取 文 件数 据 : " + data.toString()); 
}); 
}); 


以 上 代码 执行 结果 如 下 : 


$ node file.js 

准备 写 入 文件 

数据 写 入 成 功 ! 

-------- 我 是 分 割 线 ------------- 

读 取 写 入 的 数据 ! 

异步 读 取 文 件数 据 : 我 是 通过 写 入 的 文件 内 容 


、 款 > 
读 取 文件 
语法 
以 下 为 异步 模式 下 读 取 文件 的 语法 格式 : 
fs.read(fd, buffer, offset, length, position, callback) 


该 方法 使 用 了 文件 描述 符 来 读 取 文件 。 


参数 


参数 使 用 说 明 如 下 : 


。 fd - 通过 fs.open() 方法 返回 的 文件 描述 符 。 
。 buffer - 数据 写 入 的 缓冲 区 。 

。 offset - 缓冲 区 写 入 的 宇 入 偏 移 量 。 

。 length - 要 从 文件 中 读 取 的 字 节 数 。 


。 position - 文件 读 取 的 起 始 位 置 ， 如 果 position 的 值 为 null， 则 会 从 当前 文件 指针 的 位 置 
读 取 。 


。 callback - 回调 函数 ， 有 三 个 参数 err, bytesRead, buffer，err 为 错误 信息 ， bytesRead 
表示 读 取 的 字 节 数 ，buffer 为 缓冲 区 对 象 。 


实例 
input.txt 文件 内 容 为 : 


菜 乌 教程 官网 地 址 : www. runoob .com 


接 下 来 我 们 创建 file.js 文件 ， 代 码 如 下 所 示 : 


var fs = require("fs"),; 
var buf = new Buffer(1024); 


console.1log(" 准 各 打开 已 存在 的 文件 1 "); 
fs.open('input.txt', 'r+', function(err, fd) { 
if (err) { 
return console.error(err); 


} 
console .10g( "文件 打开 成 功 ! "); 
console.1og(" 准 备 读 取 文 件 : "); 
fs.read(fd, buf, 0, buf.length, ©0, function(err, bytes)t{ 
If (err)t{ 
console.1log(err); 


console.log(bytes + " 字 节 被 读 取 ")，; 


// 仅 输 出 读 取 的 字 节 
if(bytes > 0){ 

console.log(buf.slice(90, bytes).toSstring()); 
} 


}); 
}); 


以 上 代码 执行 结果 如 下 : 


$ node file.js 

准备 打开 已 存在 的 文件 ! 

文件 打开 成 功 ! 

准 各 读 取 文件 : 

42 ” 字 节 被 读 取 

菜 乌 教程 官网 地 址 : www. runoob .com 


天 闭 文 件 

语法 

以 下 为 异步 模式 下 关闭 文件 的 语法 格式 : 
fs.close(fd, callback) 


该 方法 使 用 了 文件 描述 符 来 读 取 文件 。 


参数 
参数 使 用 说 明 如 下 : 
。 fd - 通过 fs.open() 方法 返回 的 文件 描述 符 。 


。 callback - 回调 画 数 ， 没 有 参数 。 


实例 
input.txt 文件 内 容 为 : 


菜 乌 教程 官网 地 址 : www. runoob .com 


接 下 来 我 们 创建 file.js 文件 ， 代 码 如 下 所 示 : 


var fs = require("fs"),; 
var buf = new Buffer(1024); 


console.1og(" 准 各 打开 文件 1") 
fs.,open('input.txt', 'r+', function(err, fd) { 
if (err) tf 
return console.error(err); 
} 


console .10g( "文件 打开 成 功 ! "); 
console.1log(" 准 各 读 取 文 件 1"); 
fs.read(fd, buf, 0, buf.length, ©0, function(err, bytes)t{ 
If (err)t{ 
console.1log(err); 
} 


// 仅 输 出 读 取 的 字 节 
if(bytes > 0){ 

console.log(buf.slice(90, bytes).toString()); 
} 


// 关闭 文件 

fs.close(fd, function(err){ 

if (err){ 
console.1log(err); 

} 

console.1og(" 文 件 关闭 成 功 " ) ， 

}); 
}); 

}); 


以 上 代码 执行 结果 如 下 : 


$ node file.js 

准备 打开 文件 ! 

文件 打开 成 功 ! 

准备 读 取 文件 ! 

菜 乌 教程 官网 地 址 : www.runoob .com 
文件 关闭 成 功 


截取 文件 

语法 

以 下 为 异步 模式 下 截取 文件 的 语法 格式 : 
fs,.ftruncate(fd, len, callback) 


该 方法 使 用 了 文件 描述 符 来 读 取 文件 。 


参数 
参数 使 用 说 明 如 下 : 


。 fd - 通过 fs.open() 方法 返回 的 文件 描述 符 。 


。 len - 文件 内 容 截 取 的 长 度 。 


。 callback - 回调 本 数 ， 没 有 参数 。 


实例 
input.txt 文件 内 容 为 : 


SiIte:www.runoob .com 


接 下 来 我 们 创建 file.js 文件 ， 代 码 如 下 所 示 : 


var fs = require("fs"),; 
var buf = new Buffer(1024); 


console.1og(" 准 备 打开 文件 1 "); 
fs.open('input.txt', 'r+', function(err, fd) { 
if (err) { 
return console.error(err); 
} 


console .10g( "文件 打开 成 功 ! "); 
console.1lo0g( "截取 10 字 节 后 的 文件 内 容 。" ) ; 


// 截取 文件 
fs.ftruncate(fd, 10, function(err){ 
ICent 
console.1log(err); 
} 


console.1og(" 文 件 截取 成 功 。" ) ; 
console.1og(" 读 取 相同 的 文件 " ) ; 
fs.read(fd, buf, 0, buf.length, 0, function(err, bytes)t{ 
if (err){ 
console.1log(err); 
} 


// 仅 输出 读 取 的 字 节 
if(bytes > 0){ 

console.log(buf.slice(0, bytes).toString()); 
} 


// 关闭 文件 
fs.close(fd, function(err){ 
if (err){ 
console.1log(err); 


Jy 
console.1log( "文件 关闭 成 功 ! "); 
}); 


以 上 代码 执行 结果 如 下 : 


$ node file.js 

准备 打开 文件 ! 

文件 打开 成 功 ! 

截取 10 字 节 后 的 文件 内 容 。 
文件 截取 成 功 。 

读 取 相同 的 文件 
site:www.r 


文件 关闭 成 功 


删除 文件 


语 
以 下 为 删除 文件 的 语法 格式 : 


fs.unlink(path, callback) 


参数 使 用 说 明 如 下 : 
。 path - 文件 路 径 。 


e。 callback - 回调 函数 ， 没 有 参数 。 


实例 
input.txt 文件 内 容 为 : 


SiIte:www.runoob .com 


接 下 来 我 们 创建 file.js 文件 ， 代 码 如 下 所 示 : 


var fs = require("fs"),; 


console.1og(" 准 各 删除 文件 1 ") ; 
fs.unlink('input.txt', function(err) { 
If (err) { 
return console.error(err); 


jr 
console .10g( "文件 删除 成 功 ! "); 
}); 


以 上 代码 执行 结果 如 下 : 


$ node file.js 
准备 删除 文件 ! 
文件 删除 成 功 ! 


再 去 查看 input.txt 文件 ， 发 现 已 经 不 存在 了 。 


创建 目录 


语法 
以 下 为 创建 目录 的 语法 格式 : 


fs.mkdir(path[, mode], callback) 


参数 使 用 说 明 如 下 : 
。 path - 文件 路 径 。 
。 mode - 设置 目录 权限 ， 黑 认为 0777。 


。 callback - 回调 玉 数 ， 没 有 参数 。 


实例 
接 下 来 我 们 创建 file.js 文件 ， 代 码 如 下 所 示 : 


var fs = require("fs"),; 





console.1og( 创 建 目录 /tmp/test"); 
fs.mkdir('/tmp/test',function(err){ 
if (err) { 
return console.error(err); 


} 
console.1log( "目录 创 建成 功 。"); 
}); 


以 上 代码 执行 结果 如 下 : 


$ node file.js 
创建 目录 /tmp/test 
目录 创建 成 功 。 








读 取 目录 


语法 
以 下 为 读 取 目 录 的 语法 格式 : 


fs.readdir(path, callback) 


参数 使 用 说 明 如 下 : 
。 path - 文件 路 径 。 


。 callback - 回调 画 数 ， 回 调 罚 数 带 有 两 个 参数 err, files，err 为 错误 信息 ，files 为 目录 下 
的 文件 数组 列表 。 


实例 
接 下 来 我 们 创建 file.js 文件 ， 代 码 如 下 所 示 : 


var fs = require("fs"),; 


console.log(" 查 看 /tmp 目录 ") ; 
fs,readdir("/tmp/" ,function(err，files){ 
if (err) { 
return console.error(err); 


} 
files.forEach( function (file){ 
console.log( file ); 
}); 
}); 


以 上 代码 执行 结果 如 下 : 


$ node file.js 
查看 /tmp 目录 
input.out 
output.out 
test 

test.txt 


删除 目录 


语法 
以 下 为 删除 目录 的 语法 格式 : 


fs.rmdir(path, callback) 


参数 使 用 说 明 如 下 : 
。 path - 文件 路 径 。 


。 callback - 回调 函数 ， 没 有 参数 。 


实例 
接 下 来 我 们 创建 file.js 文件 ， 代 码 如 下 所 示 : 


var fs = require("fs"),; 


console,1og(" 准 备 删 除 目录 /tmp/test"); 
fs.rmdir("/tmp/test",function(err){ 
If (err) { 
return console.error(err); 


} 
console,1og(" 读 取 /tmp 目录 "); 
fs.readdir("/tmp/",function(err, files)t{ 
ol (CCT) 
return console.error(err); 


files.forEach( function (file){ 
console.log( file ); 


}); 
}); 


以 上 代码 执行 结果 如 下 : 


$ node file.js 

准备 删除 目录 /tmp/test 
Input ,out 

output.out 

WES 

[BI SAG EIE 

读 取 /tmp 目录 


文件 模块 方法 参考 手册 


以 下 为 Node.js 文件 模块 相同 的 方法 列表 : 


方法 描述 
shennan 异步 rename(). 回 调 本 数 没有 参数 ， 但 可 能 抛 出 异常 。 
newPath, callback) 
fs.ftruncate(fd, len, 异步 ftruncate(). 回 调 函 数 没有 参数 ， 但 可 能 抛 出 录 
callback) 


fs.ftruncateSync(fd, len) 同步 ftruncate() 


fs.truncate(path, len, 
callback) 


fs.truncateSync(path, len) 


fs.chown(path, uid, gid, 
callback) 


fs.chownSync(path, uid, 
gid) 


fs.fchown(fd, uid, gid, 
callback) 


fs.fchownSync(fd, uid, gid) 


fs.Ichown(path, uid, gid, 
callback) 


fs.IchownSync(path, uid, 
gid) 


fs.chmod(path, mode, 
callback) 


fs.chmodSync(path, mode) 


fs.fchmod(fd, mode, 
callback) 


fs.fchmodSync(fd, mode) 


fs.Ichmod(path, mode, 
callback) 


fs.IchmodSync(path, mode) 


fs.stat(path, callback) 


fs.lstat(path, callback) 


fs.fstat(fd, callback) 


fs.statSync(path) 
fs.lstatSync(path) 
fs.fstatSync(fd) 


fs.link(srcpath, dstpath， 
callback) 


fs.linkSync(srcpath, 
dstpath) 


fs.symlink(srcpath, 
dstpath[, type], callback) 


同步 truncate() 


异步 chown(). 回 调 函 数 没有 参数 ， 但 可 能 抛 出 异常 。 
同步 chown() 


步 fchown(). 回 调 函 数 没有 参数 ， 但 可 能 抛 出 异常 。 


站 


可 


同步 fchown() 


异步 Ichown(). 回 调 玉 数 没有 参数 ， 但 可 能 抛 出 异常 。 
同步 Ichown() 


异步 chmod(). 回 调 范 数 没 有 参数 ， 但 可 能 抛 出 异常 。 
同步 chmod(). 
异步 frhmod(). 回 调 函 数 没有 参数 ， 但 可 能 抛 出 异常 。 


同步 fchmod(). 


异步 Ichmod(). 回 调 画 数 没有 参数 ， 但 可 能 抛 出 异常 。 
Only available on Mac OS X. 


同步 Ichmod(). 


异步 stat(). 回调 函数 有 两 个 参数 err, stats，stats 是 
fs.Stats 对 象 。 


异步 lstat(). 回调 函数 有 两 个 参数 err stats，stats 是 
fs.Stats 对 象 。 


异步 fstat(). 回调 函数 有 两 个 参数 err stats，stats 是 
fs.Stats 对 象 。 


同步 stat(). 返回 fs.Stats 的 实例 。 
同步 lstat(). 返回 fs.Stats 的 实例 。 
同步 fstat(). 返回 fs.Stats 的 实例 。 


异步 link(). 回 调 男 数 没有 参数 ， 但 可 能 抛 出 异常 。 


同步 link(). 


异步 symlink(). 回 调 函 数 没有 参数 ， 但 可 能 抛 出 异常 。 
type 参数 可 以 设置 为 'dir' 'file', 或 junction' (默认 为 


dstpath[, type], callback) 
fs.symlinkSync(srcpath, 
dstpath[, type]) 
fs.readlink(path, callback) 


fs.realpath(path[, cache], 
callback) 


fs.realpathSync(path|， 
cache]) 


fs.unlink(path, callback) 
fs.unlinkSync(path) 
fs.rmdir(path, callback) 
fs.rmdirSync(path) 


fs.mkdir(path[, mode], 
callback) 


fs.mkdirSync(path[, mode]) 
fs.readdir(path, callback) 
fs.readdirSync(path) 
fs.close(fd, callback) 
fs.closeSync(fd) 


fs.open(path, flags[, model], 
callback) 


fs.openSync(path, flags[， 
mode]) 


fs.utimes(path, atime， 
mtime, callback) 


fs.utimesSync(path, atime, 
mtime) 


fs.futimes(fd, atime, mtime, 
callback) 


fs.futimesSync(fd, atime， 
mtime) 


fs.fsync(fd, callback) 
fs.fsyncSync(fd) 


fs.write(fd, buffer offset， 
length[, position], callback) 


fs.write(fd, data[, position[， 


区 关 


同步 symlink(). 


异步 readlink(). 回调 函数 有 两 个 参数 err, linkString。 


异步 realpath(). 回调 函数 有 两 个 参数 err, 


resolvedPath。 


异步 unlink(). 回 调 函 数 没有 参数 ， 但 可 能 抛 出 异常 。 


( 

同步 unlink(). 
异步 rmdir(). 回 调 梢 数 没有 参数 ， 但 可 能 抛 出 异常 。 

同步 rmdir(). 


S 异 步 mkdir(2). 回 调 函 数 没有 参数 ， 但 可 能 抛 出 异常 。 
mode defaults to 0777. 


同步 mkdir(). 

异步 readdir(3). 读 取 目录 的 内 容 。 

同步 readdir(). 返 回 文件 数组 列表 。 

异步 close(). 回 调 函 数 没 有 参数 ， 但 可 能 抛 出 异常 。 
同步 close(). 


异步 打开 文件 。 


同步 version of fs.open(). 


修改 文件 时 间 戳 ， 文 件 通过 指定 的 文件 路 径 。 


修改 文件 时 间 戳 ， 通 过 文件 描述 符 指定 。 


异步 fsync. 回 调 函 数 没有 参数 ， 但 可 能 抛 出 异常 。 
同步 fsync. 


将 缓冲 区 内 容 写 入 到 通过 文件 描述 符 指 定 的 文件 。 


encoding]l], callback) 


fs.writeSync(fd, buffer, 
offset, length[, position]) 


fs.writeSync(fd, datal, 
position[, encoding]]) 


fs.read(fd, buffer offset， 
length, position, callback) 


fs.readSync(fd, buffer, 
offset, length, position) 


fs.readFile(filename|， 
options], callback) 


fs.readFileSync(filenamel, 
options]) 


fs.writeFile(filename, datal, 
options], callback) 


fs.writeFileSync(filename, 
data[, options]) 


fs.appendFile(filename, 
data[, options], callback) 


fs.appendFileSync(filename, 
data[, options]) 


fs.watchFile(filenamel, 
options], listener) 


fs.unwatchFile(filenamel, 
listener]) 


fs.watch(filename[, options] 
[, listener]) 


fs.exists(path, callback) 
fs.existsSync(path) 


fs.access(path[, mode], 
callback) 


fs.accessSync(path[， 
mode]) 


fs.createReadStream(path[， 
options]) 


fs.createWriteStream(path|[， 
options]) 


fs.symlink(srcpath， 
dstpath[, type], callback) 


同步 版 的 fs.write()。 

同步 版 的 fs.write(). 

通过 文件 描述 符 fd 读 取 文件 内 容 。 
同步 版 的 fs.read. 


异步 读 取 文件 内 容 。 


异步 写 人 文件 内 容 。 
同步 版 的 fs.writeFile。 
异步 追加 文件 内 容 。 

The 同步 version of fs.appendFile. 
查看 文件 的 修改 。 


停止 查看 filename 的 修改 。 


查看 filename 的 修改 ，filename 可 以 是 文件 或 目录 。 
返回 fs.FSWatcher 对 象 。 


全 测 给 定 的 路 径 是 否 存在 。 


同步 版 的 fs.exists. 


测试 指定 路 径 用 户 权 限 。 
同步 版 的 fs.access。 
返回 ReadStream 对 象 。 


返回 WriteStream 对 象 。 


异步 symlink(). 回 调 函 数 没有 参数 ， 但 可 能 抛 出 异常 。 


dstpath[, type], callback) 


更 多 内 容 ， 请 查看 官网 文件 模块 描述 : File System。 


Node.js GET/POST 请 求 


在 很 多 场景 中 ， 我 们 的 服务 器 都 需要 跟 用 户 的 浏览 器 打交道 ， 如 表单 提交 。 
表单 提交 到 服务 器 一 般 都 使 用 GET/POST 请 求 。 


本 章节 我 们 将 为 大 家 介绍 Node.js GET/POST 请 求 。 


获取 GET 请 求 内 容 


由 于 GET 请 求 直接 被 嵌入 在 路 笃 中 ，URL 是 完整 的 请 求 路 笃 ， 包 括 了 ?后 面 的 部 分 ， 因 此 你 可 
以 手动 解析 后 面 的 内 容 作为 GET 请 求 的 参数 。 


node.js 中 url 模 块 中 的 parse 函 数 提供 了 这 个 功能 。 


var http = require('http'); 

var url = require('url'); 

var util = require('util'); 

http.createServer(function(req, res)t 
res.writeHead(200, {'Content-Type': 'text/plain'}); 
res.end(util.inspect(url.parse(req.url, true))); 

}).listen(3000); 


在 浏览 器 中 访问 http://localhost:3000/user?name=w3c&email=w3c@w3cschool.cc 然后 查看 返回 


结果 : 


获取 POST 请 求 内 容 
POST 请 求 的 内 容 全 部 的 都 在 请 求 体 中 ，http.ServerRequest 并 没有 一 个 属性 内 容 为 请 求 体 ， 
原因 是 等 待 请 求 体 传 输 可 能 是 一 件 耗 时 的 工作 。 


比如 上 传 文件 ， 而 很 多 时 候 我 们 可 能 并 不 需要 理会 请 求 体 的 内 容 ， 悉 意 的 POST 请 求 会 大 大 消 
耗 服务 器 的 资源 ， 所 有 node.js 默 认 是 不 会 解析 请 求 体 的 ， 当 你 需要 的 时 候 ， 需 要 手动 来 做 。 


var http = require('http'); 
var querystring = require('querystring'); 
var util = require('util'); 


http.createServer(function(req, res)t{ 
var post = ''; // 定 义 了 一 个 post 变 量 ， 用 于 暂 存 请 求 体 的 信息 


req.on('data', function(chunk){ // 通 过 reqd 的 data 事 件 监听 函数 ， 每 当 接 受到 请 求 体 的 数据 ， 就 累 力 
post += chunk; 
}); 


req.on('end', function(){ // 在 end 事 件 触发 后 ， 通 过 querystring.parse 将 post 解 析 为 真正 的 POS 
post = querystring.parse(post); 
res.end(util.inspect(post)); 


}); 
}).listen(3000); 


图 一 一 





Node.js 工具 模块 


在 Node.js 模块 库 中 有 很 多 好 用 的 模块 。 接 下 来 我 们 为 大 家 介绍 几 种 常用 模块 的 使 用 : 


模块 名 
OS 模块 
Path 模块 
Net 模块 
DNS 模块 


Domain 模块 


描述 
提供 基本 的 系统 操作 男 数 。 
提供 了 你 理 和 转换 文件 路 的 工具 。 
用 于 底层 的 网 络 通信 。 提 供 了 服务 端 和 客户 端的 的 操作 。 
用 于 解析 域名 。 
简化 异步 代码 的 异常 人 处理， 可 以 捕捉 处 理 try catch 无 法 捕捉 的 。 


Node.js OS 模块 


Node.js os 模块 提供 了 一 些 基本 的 系统 操作 男 数 。 我 们 可 以 通过 以 下 方式 引入 该 模块 : 


var os = require("os") 


方法 


方法 描述 
os.tmpdir() 返回 操作 系统 的 默认 临时 文件 夹 。 
os.endianness() 返回 CPU 的 字 节 序 ， 可 能 的 是 "BE" 或 "LE"。 
os.hostnamel) 返回 操作 系统 的 主机 名 。 
os.typel() 返回 操作 系统 名 
os.platform(() 返回 操作 系统 名 
有 全 丽人 CPU 架构 ， 可 能 的 值 有 "x64"、"arm" 和 
os.release() 返回 操作 系统 的 发 行 版 本 。 
os.uptime() 返回 操作 系统 运行 的 时 间 ， 以 秒 为 单位 。 
os.loadavg() 返回 一 个 包含 1、5、15 分 钟 平均 负载 的 数组 。 
os.totalmem() 返回 系统 内 存 总 量 ， 单 位 为 字 节 。 
os.freemem() 返回 操作 系统 空闲 内 存量 ， 单 位 是 字 节 。 

返回 一 个 对 象 数组 ， 包 含 所 安装 的 每 个 CPU/ 内 核 的 信息 : 型 

os.cpus() 号 、 速 度 (单位 MHz) 、 时 间 (一 个 包含 user、nice、 


sys、idle 和 irq 所 使 用 CPU/ 内 核 毫 秒 数 的 对 象 )。 
os.networklnterfaces() ”获得 网 络 接口 列表 。 


属性 


属性 描述 
os.EOL 定义 了 操作 系统 的 行 尾 符 的 常量 。 


实例 


创建 main.js 文件 ， 代 码 如 下 所 示 : 


var os = require("os"); // CPU 的 字 节 序 console.log('endianness : ' + 0s.endianness()); 
‘| | 
代码 执行 结果 如 下 : 








$ node main.js 

endianness : LE 

type : Linux platform : linux 

total memory : 25103400960 bytes,. free memory : 20676710400 bytes. 


Node.js Path 模块 


Node.js path 模块 提供 了 一 些 用 于 处 理 文件 路 径 的 小 工具 ， 我 们 可 以 通过 以 下 方式 引入 该 模 
块 : 


var path = require("path") 


方法 


方法 描述 
path.normalize(p) 规范 化 路 径 ， 注 意 … 和 '."。 
path.join([path1][， 用 于 连接 路 径 。 该 方法 的 主要 用 途 在 于 ， 会 正确 使 用 当前 系 
path2][, …]) 统 的 路 径 分 隔 符 ，Unix 系 统 是 ""，Windows 系 统 是 "\"。 
的 80 ve rm 小 将 to 参数 解析 为 绝对 路 径 。 
path.isAbsolute(path) 判断 参数 path 是 否 是 绝对 路 径 。 


path.relative(from, to) 用 于 将 相对 路 径 转 为 绝对 路 径 。 


返回 路 径 中 代表 文件 夹 的 部 分 ， 同 Unix 的 dirname 命令 类 

似 。 

path.basename(p[, ext]) ”返回 路 径 中 的 最 后 一 部 分 。 同 Unix 命令 bashname 类 似 。 
返回 路 径 中 文件 的 后 级 名 ， 即 路 径 中 最 后 一 个 '.' 之 后 的 部 

path.extname(p) 分 。 如 果 一 个 路 径 中 并 不 包含 '' 或 该 路 径 只 包含 一 个 ".' 且 这 
个 '. 为 路 径 的 第 一 个 字符 ， 则 此 命令 返回 空 字 符 串 。 

path.parse(pathString) 返回 路 径 字 符 串 的 对 象 。 

path.format(pathObject) ”从 对 象 中 返回 路 径 字 符 串 ， 和 path.parse 相反 。 


path.dirname(p) 


属性 


属性 描述 
path.sep 平台 的 文件 路 径 分 隔 符 ，\ 或 /。 
path.delimiter 平台 的 分 隔 符 , ; or ". 
path.posix 提供 上 述 path 的 方法 ， 不 过 总 是 以 posix 兼容 的 方式 交互 。 
path.win32 提供 上 述 path 的 方法 ， 不 过 总 是 以 win32 兼容 的 方式 交互 。 


实例 


创建 main.js 文件 ， 代 码 如 下 所 示 : 


var path = require("path"); 


// 格式 化 路 径 


console.1og('normalization : ' + path.normalize('/test/test1//2slashes/1slash/tab/..')); 


// 连接 路 径 
console.log('joint path : ' + path.join('/test', 'test1i', '2slashes/1islash', 'tab', '..') 


// 转换 为 绝对 路 径 
console.log('resolve : ' + path.resolve('main.js')); 


// 路 径 中 文件 的 后 级 名 


console.log('ext name : ' + path.extname('main.js')); 
xx 
代码 执行 结果 如 下 : 





$ node main.js 

normalization : /test/test1/2slashes/1slash 
joint path : /test/test1/2slashes/1slash 
resolve : /web/com/1427176256_27423/main.js 
ext name : .js 


Node.js Net 模块 


Node.js Net 模块 提供 了 一 些 用 于 底层 的 网 络 通信 的 小 工具 ， 包 含 了 创建 服务 器 /客户 端的 方 
法 ， 我 们 可 以 通过 以 下 方式 引入 该 模块 : 


var net = require("net") 


方法 


方法 描述 
net.createServer([options][， 创建 一 个 TCP 服务 器 。 参 数 connectionListener 自 
connectionListener]) 动 给 'connection' 事件 创建 监听 器 。 


返回 一 个 新 的 'net.Socket'， 并 连接 到 指定 的 地 址 和 


net.connect(options|, 和 计 A . 
connectionListener]) 人 当 socket 建立 的 时 候 ， 将 会 触发 "connect 


net.createConnection(options[， ”创建 一 个 到 端口 port 和 主机 host 的 TCP 连接 。 


connectionListener]) host 默认 为 localhost'。 

创建 一 个 端口 为 port 和 主机 为 host 的 TCP 连接 。 
net.connect(port[, host]l, host 默认 为 localhost'。 参 数 connectListener 将 会 
connectListener]) 作为 监听 器 添加 到 'connect' 事件。 返回 


met.Socket 。 


创建 一 个 端口 为 port 和 主机 为 host 的 TCP 连接 。 


net.createConnection(port[， host 默认 为 localhost'。 参 数 connectListener 将 会 
host][, connectListener]) 作为 监听 器 添加 到 'connect' 事件。 返回 


met.Socket 。 


创建 连接 到 path 的 unix socket 。 参 数 
Deb oonnes Panl, connectListener 将 会 作为 监听 器 添加 到 'connect' 
connectListener]) 事件 上 返回 metSocket 


创建 连接 到 path 的 unix socket 。 参 数 


net.createConnection(pathl, connectListener 将 会 作为 监听 器 添加 到 'connect' 





on nese 事件 。 返 回 'net.Socket'。 

net.isIP(input) in i IPV4 返回 4， IPV6 
net.isIPv4(input) ND IPV4， 返回 true， 否 则 返回 
net.isIPv6(input) 人 IPV6， 返回 true， 否 则 返回 


net.Server 


net.Server 通 常用 于 创建 一 个 TCP 或 本 地 服务 器 。 


方法 


server.listen(port[, host][， 
backlog][, callback]) 


serverlisten(path[, callback]) 


serverlisten(handle[, callback]) 


server.listen(options[, callback]) 


server.close([callback]) 


serveraddress() 


server.unref() 


server.ref() 


server.getConnections(callback) 


描述 


监听 指定 端口 port 和 主机 host ac 连接 。 默认 情 
况 下 host 接受 任何 IPv4 地 址 (INADDR_ANY) 的 
直接 连接 。 端 口 port 为 0 时 ， 则 会 分 配 一 个 随机 
端口 。 


通过 指定 path 的 连接 ， 和 启动 一 个 本 地 socket 服务 
二 


通过 指定 句柄 连接 。 


options 的 属性 : 端口 port, 主机 host, 和 backlog,， 
以 及 可 选 参数 callback 画 数 , 他 们 在 一 起 调用 
server.listen(port, [host], [backlog], [callback])。 还 
有 ， 参 数 path 可 以 用 来 指定 UNIX socket。 


服务 器 停止 接收 新 的 连接 ， 保 持 现 有 连接 。 这 是 异 
步 画 数 ， 当 所 有 连接 结束 的 时 候 服 务 器 会 关闭 ， 并 
会 触发 'close' 事件 。 


操作 系统 返回 绑 定 的 地 址 ， 协 议 族 名 和 服务 器 端 
国内 


如 果 这 是 事件 系统 中 唯一 一 个 活动 的 服务 器 ， 调 用 
unref 将 允许 程序 退出 。 


与 unref 相反 ， 如 果 这 是 唯一 的 服务 器 ， 在 之 前 被 
unref 了 的 服务 器 上 调用 ref 将 不 会 让 程序 退出 
(默认 行为 ) 。 如 果 服 务 器 已 经 被 ref， 则 再 次 调 
用 ref 并 不 会 产生 影响 。 


异步 获取 服务 器 当前 活跃 连接 的 数量 。 当 socket 
发 送 给 子 进程 后 地 有 效 ; 回调 函数 有 2 个 参数 err 
和 count。 


事件 
事件 描述 
listening 当 服 务 器 调用 server.listen 绑 定 后 会 触发 。 


connection ” 当 新 连接 创建 后 会 被 触发 。socket 是 net.Socket 实 例 。 
服务 器 关闭 时 会 触发 。 注 意 ， 如 果 存 在 连接 ， 这 个 事件 不 会 被 触发 直到 所 


CloSe 有 的 连接 关闭 。 


error 发 生 错误 时 触发 。'close' 事件 将 被 下 列 事件 直接 调用 。 


net.Socket 


net.Socket 对 象 是 TCP 或 UNIX Socket 的 抽象 。net.Socket 实例 实现 了 一 个 双 工 流 接 口 。 
他 们 可 以 在 用 户 创建 客户 端 (使 用 connect()) 时 使 用 , 或 者 由 Node 创建 它们 ， 并 通过 
connection 服务 器 事件 传递 给 用 户 。 


事件 
net.Socket 事件 有 : 
事件 描述 
lookup 在 解析 域名 后 ， 但 在 连接 前 ， 触 发 这 个 事件 。 对 UNIX sokcet 不 适用 。 
connect ”成 功 建立 socket 连接 时 触发 。 
data 当 接 收 到 数据 时 触发 。 
end 当 socket 另 一 端 发送 FIN 包 时 ， 触 发 该 事件 。 
人 当 socket 空 亲 超时 时 触发 ， 仅 是 表明 socket 已 经 空闲 。 用 户 必须 手动 关闭 
连接 。 
drain 当 写 缓存 为 空 得 时 候 触 发 。 可 用 来 控制 上 传 。 
error 错误 发 生 时 触发 。 
i 当 socket 完全 关闭 时 触发 。 参 数 had_error 是 布尔 值 ， 它 表示 是 否 因为 传输 
错误 导致 socket 关闭 。 
属性 
net.Socket 提供 了 很 多 有 用 的 属性 ， 便 于 控制 socket 交互 : 
属性 描述 
socket.bufferSize 该 属性 显示 了 要 写 入 缓冲 区 的 字 节 数 。 


socket.remoteAddress 


远程 的 IP 地 址 字符 串 ， 例 如 : '74.125.127.100' or 
'2001:4860:a005::68'。 


socket.remoteFamily 远程 IP 协 议 族 字符 串 ， 上 比如 'IPv4' or 'IPv6'。 


socket.remotePort 远程 端口 ， 数 字 表 示 ， 例 如 : 80 or 21。 


网 络 连 接线 定 的 本 地 接口 远程 客户 端正 在 连接 的 本 地 IP 地 


socket.localAddress 址 ， 字 符 串 表示 。 人 例如， 如果 你 在 监听 '0.0.0.0' 而 客户 端 连 接 


在 '192.168.1.1'， 这 个 值 就 会 是 '192.168.1.1'。 


socket.localPort 本 地 端口 地 址 ， 数 字 表 示 。 例 如 : 80 or 21。 
socket.bytesRead 接收 到 得 字 节 数 。 
socket.bytesWritten 发 送 的 字 节 数 。 


TutorialsPoint 后 端 教程 


方法 
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方法 


new net.Socket([options]) 


socket.connect(port[, host]l, 
connectListener]) 


Socket.connect(path[， 
connectListener]) 


socket.setEncoding([encoding]) 


socket.write(data[, encodingl]l, 
callback]) 


socket.end([datal[, encoding]) 


socket.destroy!() 


socket.pause!() 


socket.resume() 


socket.setTimeout(timeout|l, 
callback]) 


socket.setNoDelay([noDelay]) 


socket.setKeepAlive([enablel]l, 
initialDelay]) 


Socket.address() 


socket.unref() 


socket.ref() 


描述 
构造 一 个 新 的 socket 对 象 。 


指定 端口 port 和 主机 host， 创 建 socket 连接 。 
参数 host 默认 为 localhost。 通 常情 况 不 需要 使 用 
net.createConnection 打开 socket。 只 有 你 实现 了 
自己 的 socket 时 才 会 用 到 。 


打开 指定 路 径 的 unix socket。 通 常情 况 不 需要 使 
用 net.createConnection 打开 socket。 只 有 你 实现 
了 自己 的 socket 时 才 会 用 到 。 


置 编 码 


在 socket 上 发 送 数据 。 第 二 个 参数 指定 了 字符 串 
的 编码 ， 默 认 是 UTF8 编码 。 


半 关 闭 socket。 例 如 ， 它 发 送 一 个 FIN 包 。 可 能 
服务 器 仍 在 发 送 数 据 。 


确保 没有 |/O 活动 在 这 个 套 接 字 上 。 只 有 在 错误 发 
生 情 况 下 才 需 要 。 (义理 错误 等 等 ) 。 


暂停 读 取 数据 。 就 是 说 ， 不 会 再 触发 data 事件 。 
对 于 控制 上 传 非常 有 用 。 


调用 pause() 后 想 恢 复读 取 数 据 。 


socket 闲置 时 间 超 过 
设置 为 超时 。 


禁用 纳 格 (Nagle) 算法 。 默 认 情况 下 TCP 连接 使 
用 纳 格 算法 ， 在 发 送 前 他 们 会 缓冲 数据 。 将 
noDelay 设置 为 true 将 会 在 调用 socket.write() 时 
立即 发 送 数据 。noDelay 默认 值 为 true。 


禁用 /启用 长 连接 功能 ， 并 在 发 送 第 一 个 在 闲置 
socket 上 的 长 连接 probe 之 前 ， 可 选 地 设 定 初 始 
延 时 。 上 默认 为 false。 设 定 initialDelay (毫秒 ) ， 
来 设 定 收 到 的 最 后 一 个 数据 包 和 第 一 个 长 连接 
probe 之 间 的 延 时 。 将 initialDelay 设 为 0， 将 会 保 
留 默 认 (或 者 之 前 ) 的 值 。 默 认 值 为 0. 


操作 系统 返回 绑 定 的 地 址 ， 协 议 族 名 和 服务 器 端 
口 。 返 回 的 对 象 有 3 个 属性 ， 比 如 { port: 12346， 
family: 'IPv4', address: '127.0.0.1 }。 


如 果 这 是 事件 系统 中 唯一 一 个 活动 的 服务 器 ， 调 用 
unref 将 允许 程序 退出 。 如 果 服 务 器 已 被 unref， 则 
再 次 调用 unref 并 不 会 产生 影响 。 


与 unref 相反 ， 如 果 这 是 唯一 的 服务 器 ， 在 之 前 被 
unref 了 的 服务 器 上 调用 ref 将 不 会 让 程序 退出 

(默认 行为 ) 。 如 果 服 务 器 已 经 被 ref， 则 再 次 调 
用 ref 并 不 会 产生 影 响 。 


timeout 毫秒 后 ， 将 socket 


实例 
创建 server.js 文件 ， 代 码 如 下 所 示 : 


var net = require('net'); 

var server = net.createServer(function(connection) { 
console.log('client connected'); 
connection.on('end', function() { 

console.10g(' 客 户 端 关 闭 连 接 ' ) ; 

}); 
connection.write('Hello World!\r\n'); 
connection.pipe(connection); 

}); 

server.listen(8080, function() { 
console.log('server is listening'); 


}); 


执行 以 上 服务 端 代码 : 


$ node Server ,js 
server is listening  # 服务 已 创建 并 监听 8080 端口 


新 开 一 个 窗口 ， 创 建 client.js 文件 ， 代 码 如 下 所 示 : 


var net = require('net'); 

var client = net.connect({port: 8080}, function() { 
console.10g(' 连 接 到 服务 器 ! ' ); 

}); 

client.on('data', function(data) { 
console.log(data.toSstring()); 
client.end(); 


}); 


client.on('end', function() { 
console .1log(' 断 开 和 与 服务 器 的 连接 ' ) ; 
}); 


执行 以 上 客户 端的 代码 : 
连接 到 服务 器 ! 
Hello World! 


断 开 与 服务 器 的 连接 


Gif 实例 演示 


Node.js DNS 模块 


Node.js DNS 模块 用 于 解析 域名 。 引 入 DNS 模块 语法 格式 如 下 : 


var dns = require("dns") 


方法 


方法 


dns.lookup(hostname[， 
options], callback) 


dns.lookupService(address, 
port, callback) 


dns.resolve(hostnamel, 
rrtype], callback) 


dns.resolve4(hostname, 
callback) 


dns.resolve6(hostname, 
callback) 


dns.resolveMx(hostname, 
callback) 


dns.resolveTxt(hostname, 
callback) 


dns.resolveSrv(hostname, 
callback) 


dns.resolveSoa(hostname, 
callback) 


dns.resolveNs(hostname, 
callback) 


dns.resolveCname(hostname, 
callback) 


dns.reverse(ip, callback) 
dns.getServers() 


dns.setServers(servers) 


rrtypes 


描述 


将 域名 (比如 'runoob.com') 解析 为 第 一 条 找到 的 记 
录 A (IPV4) 或 AAAA(IPV6)。 参 数 options 可 以 是 
一 个 对 象 或 整数 。 如 果 没 有 提供 options，IP v4 和 
v6 地 址 都 可 以 。 如 果 options 是 整数 ， 则 必须 是 4 或 
6。 


使 用 getnameinfo 解析 传人 的 地 址 和 端口 为 域名 和 服 
务 。 


将 一 个 域名 (如 runoob.com'") 解析 为 一 个 rrtype 指 
定 记 录 类 型 的 数组 。 


和 dns.resolve() 类 似 , 仅 能 查询 IPv4 (A 记录 ) 。 
addresses IPv4 地 址 数组 (比如 ，[74.125.79.104'， 
'74.125.79.105', '74.125.79.106']) 。 


和 dns.resolve4() 类 似 ， 仅 能 查询 IPv6( AAAA 查 


询 ) 


和 dns.resolve() 类 似 , 仅 能 查询 邮件 交换 (MX 记 
录 )。 


和 dns.resolve() 类 似 , 仅 能 进行 文本 查询 (TXT 记 
录 ) 。 addresses 是 2-d 文本 记录 数组 。( 比 如 ，[ 
[v=spf1 ip4:0.0.0.0 , '~all ] ]) 。 每 个 子 数组 包含 一 
条 记录 的 TXT 块 。 根 据 使 用 情况 可 以 连接 在 一 起 ， 
也 可 单独 使 用 。 


和 dns.resolve() 类 似 , 仅 能 进行 服务 记录 查询 (SRV 
记录 ) 。 addresses 是 hostname 可 用 的 SRV 记录 
数组 。 SRV 记录 属性 有 优先 级 (priority) ， 权 重 
(weight) ,端口 (port) ,和 名 字 (name) (比如 ， 
[fpriority: 10, 'weight': 5，port: 21223, name': 
'service.example.com'}, ...]) 。 


和 dns.resolve() 类 似 , 仅 能 查询 权威 记录 (SOA 记 
录 ) 。 


和 dns.resolve() 类 似 , 仅 能 进行 域名 服务 器 记录 查询 
(NS 记录 ) 。 addresses 是 域名 服务 器 记录 数组 

(hostname 可 以 使 用 ) (比如 , ['ns1.example.com, 
'ns2.example.com']) 。 


和 dns.resolve() 类 似 , 仅 能 进行 别名 记录 查询 
(CNAME 记 录 )。addresses 是 对 hostname 可 用 的 别 
名 记录 数组 (比如 ，, ['bar.example.com']) 。 


反 向 解析 IP 地 址 ， 指 向 该 IP 地 址 的 域名 数组 。 
返回 一 个 用 于 当前 解析 的 IP 地 址 数组 的 字符 串 。 
指定 一 组 IP 地 址 作为 解析 服务 器 。 


以 下 列 出 了 dns.resolve() 方法 中 有 效 的 rrtypes 值 : 


'A' IPV4 地 址 , 默认 
'AAAA' IPV6 地 址 

'MX' 邮件 交换 记录 

'TXT' text 记录 

'SRV' SRV 记录 

'PTR' 用 来 反 向 IP 查找 
'NS' 域名 服务 器 记录 
'CNAME' 别名 记录 

'SOA' 授权 记录 的 初始 值 


错误 码 


每 次 DNS 查询 都 可 能 返回 以 下 错误 码 : 


dns .NODATA : 无 数据 响应 。 

dns.FORMERR : 查询 格式 错误 。 

dns.SERVFAIL : 常规 失败 。 

dns.NOTFOUND : 没有 找到 域名 。 

dns .NOTIMP : 未 实现 请 求 的 操作 。 
dns.REFUSED : 拒绝 查询 。 

dns.BADQUERY : 查询 格式 错误 。 

dns .BADNAME : 域名 格式 错误 。 

dns.BADFAMILY : 地 址 协议 不 支持 。 
dns.BADRESP : 回复 格式 错误 。 

dns .CONNREFUSED : 无 法 连接 到 DNS 服务 器 。 
dns.TIMEOUT : 连接 DNS 服务 器 超时 。 
dns,EOF : 文件 末端 。 

dns.FILE : 读 文件 错误 。 

dns .NOMEM : 内 存 浴 出 。 

dns .DESTRUCTION : 通道 被 摧毁 。 

dns.BADSTR : 字符 串 格 式 错误 。 

dns .BADFLAGS : 非法 标识 符 。 

dns.NONAME : 所 给 主机 不 是 数字 。 

dns .BADHINTS : 非法 HINTS 标 识 符 。 

dns .NOTINITIALIZED : C Cc-ares 库 尚 未 初始 化 。 
dns.LOADIPHLPAPI : 加 载 iphlpapi.dll 出 错 。 
dns .ADDRGETNETWORKPARAMS : 无 法 找到 GetNetworkParams 辑 数 。 
dns.CANCELLED : 取消 DNS 查询 。 


实例 
创建 main.js 文件 ， 代 码 如 下 所 示 : 


var dns = require('dns'); 


dns.lookup('www.github.com', function onLookup(err, address, family) { 
console.1og('ip 地 址 :'，address); 
dns.reverse(address, function (err, hostnames) { 
if (err) { 
console.log(err.stack); 
} 


console.1og(' 反 向 解析 ' + address + ': ' + JSON.stringify(hostnames)); 
}); 
}); 
执行 以 上 代码 ， 结 果 如 下 所 示 : 


address: 192.30.252.130 
reverse for 192.30.252.130: ["github.com"] 


Node.js Domain 模块 


Node.js Domain( 域 ) 简化 异步 代码 的 异常 处 理 ， 可 以 捕捉 处 理 try catch 无 法 捕捉 的 异常 。 引 
入 Domain 模块 语法 格式 如 下 : 


var domain = require("domain") 


domain 模 块 ， 把 处 理 多 个 不 同 的 IO 的 操作 作为 一 个 组 。 注 册 事 件 和 回调 到 domain， 当 发 生 一 
个 错误 事件 或 抛 出 一 个 错误 时 ，domain 对 象 会 被 通知 ， 不 会 丢失 上 下 文 环境 ， 也 不 导致 程序 
错误 立即 推出 ， 和 与 process.on('uncaughtException') 不 同 。 

Domain 模块 可 分 为 隐 式 绑 定 和 显 式 绑 定 : 


e 隐 式 绑 定 : 把 在 domain 上 下 文中 定义 的 变量 ， 自 动 绑 定 到 domain 对 象 
。 显 式 绑 定 : 把 不 是 在 domain 上 下 文中 定义 的 变量 ， 以 代码 的 方式 绑 定 到 domain 对 象 


方法 


方法 描述 


在 域 的 上 下 文 运行 提供 的 函数 ， 隐 式 的 绑 定 了 所 有 的 事 
件 分 发 器 ， 计 时 器 和 底层 请 求 。 


domain.run(function) 


domain.add(emitter) 显 式 的 增加 事件 
domain.remove(emitter) 删除 事件 。 

返回 的 函数 是 一 个 对 于 所 提供 的 回调 函数 的 包装 本 数 。 
domain.bind(callback) 当 调 用 这 个 返回 的 函数 被 时 ， 所 有 被 抛 出 的 错误 都 会 被 


导向 到 这 个 域 的 error 事件 。 


和 domain.bind(callback) 类 似 。 除 了 捕捉 被 抛 出 的 错误 
外 ， 它 还 会 拦截 Error 对 象 作为 参数 传递 到 这 个 画 数 。 


domain.enter() 进入 一 个 异步 调用 的 上 下 文 ， 绑 定 到 domain。 


退出 当前 的 domain， 切 换 到 不 同 的 链 的 异步 调用 的 上 下 
文中 。 对 应 domain.enter()。 


domain.intercept(callback) 


domain.exit() 


domain.dispose() 释放 一 个 domain 对 象 ， 让 node 进 程 回 收 这 部 分 资源 。 
domain.create() 返回 一 个 domain 对 象 。 


属性 


属性 描述 
domain.members 已 加 入 domain 对 象 的 域 定时 器 和 事件 发 射 器 的 数组 。 


实例 
创建 main.js 文件 ， 代 码 如 下 所 示 : 


Var EventEmitter = require("events").EventEmitter; 
var domain = require("domain"); 


var emitter1 = new EventEmitter(); 


// 创建 域 


var domain1 = domain.create(); 


domain1i.on('error', function(err){ 
console.1og("domain1 处 理 这 个 错误 ("+err.message+")"); 


}); 


// 显 式 绑 定 
domaini.add(emitter1); 


emitter1i.on('error',function(err){ 
console.10og(" 监 听 器 义理 此 错误 ("+err.message+")"); 


}); 

emitteri.emit('error',new Error(' 通 过 监听 器 来 人 处理 ' ) ) ; 
emitteri.removeAllListeners('error'); 
emitteri.emit('error',new Error(' 通 过 domain1 义理 ' ) ); 
var domain2 = domain.create(); 


domain2.on('error', function(err){ 
console.1og("domain2 义理 这 个 错误 ("+err.message+")"); 


}); 


// 隐 式 绑 定 

domain2.run(function(){ 
Var emitter2 = new EventEmitter(); 
emitter2.emit('error',new Error(' 通 过 domain2 处 理 ')); 


}); 


domaini.remove(emitter1); 
emitter1.emit('error'，new Error(' 转 换 为 异常 ， 系 统 将 崩 演 !')); 


执行 以 上 代码 ， 结 果 如 下 所 示 : 


监听 器 处 理 此 错误 (通过 监听 器 来 处 理 ) 
domain1 人 处理 这 个 错误 (通过 domain1 处 理 ) 
domain2 人 处理 这 个 错误 (通过 domain2 处 理 ) 


events.js:72 
throw er; // Unhandled 'error' event 
八 
Error: 转换 为 异常 ， 系 统 将 崩溃 ! 
at Object.<anonymous> (/www/node/main.js:40:24) 
at Module._compile (module.js:456:26) 
at Object.Module. extensions..]js (module.js:474:10) 
at Module.]load (module.js:356:32) 
at Function.Module._load (module.js:312:12) 
at Function.Module.runMain (module.js:497:10) 
at startup (node.js:119:16) 
at node.js:929:3 


Node.js Web 模块 


什么 是 Web 服务 器 ? 


Web 服 务 器 一 般 指 网 站 服务 器 ， 是 指 驻 留 于 因特网 上 某 种 类 型 计算 机 的 程序 ，Web 服 务 器 的 
基本 功能 就 是 提供 Web 信 息 浏 览 服务 。 它 只 需 支持 HTTP 协 议 、HTML 文 档 格 式 及 URL， 与 客 
户 端 的 网 络 浏览 器 配合 。 


大 多 数 web 服务 器 都 支持 服务 端的 脚本 语言 (php、python、ruby) 等 ， 并 通过 脚本 语言 从 
数据 库 获取 数据 ， 将 结果 返回 给 客户 端 浏 览 器 。 


目前 最 主流 的 三 个 Web 服 务 器 是 Apache、Nginx、1IS。 


Web 应 用 架构 


e。 Client - 客户 端 ， 一 般 指 浏 览 器 ， 浏 览 器 可 以 通过 HTTP 协议 向 服务 器 请 求 数 据 。 


。 Server - 服务 端 ， 一 般 指 Web 服务 器 ， 可 以 接收 客户 端 请 求 ， 并 向 客户 端 发 送 响 应 数 
据 。 


。 Business - 业务 层 ， 通过 Web 服务 器 处 理应 用 程序 ， 如 与 数据 库 交 互 ， 逻 辑 运 算 ， 调 
用 外 部 程序 等 。 


Data - 数据 层 ， 一 般 由 数据 库 组 成 。 


使 用 Node 创建 Web 服务 器 


Node.js 提供 了 http 模块 ，http 模块 主要 用 于 搭建 HTTP 服务 端 和 客户 端 ， 使 用 HTTP 服务 
器 或 客户 端 功能 必须 调用 http 模块 ， 代 码 如 下 : 


var http = require('http'); 


以 下 是 演示 一 个 最 基本 的 HTTP 服务 器 架构 (使 用 8081 端 口 )， 创 建 server.js 文件 ， 代 码 如 下 
所 示 : 


var http = require('http'); 
var fs = require('fs'); 
var url = require('url'); 


// 创建 服务 器 
http.createServer( function (request, response) { 
// 解析 请 求 ， 包 括 文件 名 


var pathname = url.parse(request.url).pathname; 


// 输出 请 求 的 文件 名 


console.log("Request for " + pathname + " received."); 


// 从 文件 系统 中 读 取 请 求 的 文件 内 容 
fs.readFile(pathname.substr(1), function (err, data) { 
if "(err) Tt 
console.1log(err); 
// HTTP 状态 码 : 404 : NOT FOUND 
// Content Type: text/plain 
response.writeHead(404, {'Content-Type': 'text/html'}); 
}elsef{ 
// HTTP 状态 码 : 209 : OK 
// Content Type: text/plain 
response.writeHead(200, {'Content-Type': 'text/html'}); 


// 响应 文件 内 容 
response.write(data.tostring()); 


} 
// ”发 送 响应 数据 
response.end( ); 


}); 
}).listen(8081); 


// 控制 台 会 输出 以 下 信息 
console.log('Server running at http://127.0.0.1:8081/'); 


接 下 来 我 们 在 该 目录 下 创建 一 个 index.htm 文件 ， 代 码 如 下 : 


<html> 

<head> 

<title>Sample Page</title> 
</head> 

<body> 

Hello World! 

</body> 

</html> 


执行 server.js 文件 : 


$ node server.js 
Server running at http://127.0.0.1:8081/ 


接着 我 们 在 浏览 器 中 打开 地 址 : http://127.0.0.1:8081/index.htm， 显 示 如 下 图 所 示 : 


执行 server.js 的 控制 台 输 出 信息 如 下 : 


Server running at http://127.0.0.1:8081/ 
Request for /index.htm received . # 客户 端 请 求 信息 


使 用 Node 创建 Web 客户 站 


Node 创建 Web 客户 端 需要 引入 http 模块 ， 创 建 client.js 文件 ， 代 码 如 下 所 示 : 


<pre> 
var http = require('http'); 


// 用 于 请 求 的 选项 

Var options = { 
host: 'localhost', 
port: '8081', 
path: '/index.htm' 

}; 


// 处 理 响 应 的 回调 函数 
var callback = function(response)t{ 
// 不 断 更 新 数据 
Var body = "'，; 
response.on('data', function(data) { 
body += data; 
}); 


response.on('end', function() { 
// 数据 接收 完成 
console.1log(body); 

}); 


} 

// 向 服务 端 发 送 请 求 

var req = http.request(options, callback); 
req.end(); 


新 开 一 个 终端 ， 执 行 client.js 文件 ， 输 出 结果 如 下 : 


$ node client.js 

<html> 

<head> 

<title>Sample Page</title> 
</head> 

<body> 

Hello World! 

</body> 

</html> 


执行 server.js 的 控制 台 输 出 信息 如 下 : 


Server running at http://127.0.0.1:8081/ 
Request for /index.htm received.  # 客户 端 请 求 信息 





Node.js Express 框架 


Express 简介 
Express 是 一 个 简洁 而 灵活 的 node.js Web 应 用 框架 , 提供 了 一 系列 强大 特性 帮助 你 创建 各 种 
Web 应 用 ， 和 丰富 的 HTTP 工具 。 
使 用 Express 可 以 快速 地 搭建 一 个 完整 功能 的 网 站 。 
Express 框架 核心 特性 : 
。 可 以 设置 中 间 件 来 响应 HTTP 请 求 。 
。 定义 了 路 由 表 用 于 执行 不 同 的 HTTP 请 求 动作 。 


。 可 以 通过 向 模板 传递 参数 来 动态 泻 染 HTML 页 面 。 


安装 Express 
安装 Express 并 将 其 保存 到 依赖 列表 中 : 


$ npm install express --Save 


以 上 命令 会 将 Express 框架 安装 在 当期 目录 的 node_modules 目录 中 ， node_modules 目 
录 下 会 自动 创建 express 目录 。 以 下 几 个 重要 的 模块 是 需要 与 express 框架 一 起 安装 的 : 


。 body-parser - node.js 中 间 件 ， 用 于 人 处理 JSON, Raw, Text 和 URL 编码 的 数据 。 


。 cookie-parser - 这 就 是 一 个 解析 Cookie 的 工具 。 通 过 req.cookies 可 以 取 到 传 过 来 的 
cookie， 并 把 它们 转 成 对 象 。 


。 multer - node.js 中 间 件 ， 用 于 处 理 enctype="multipart/form-data" (设置 表单 的 MIME 编 
码 ) 的 表单 数据 。 


npm install body-parser --save 
npm install cookie-parser --save 
npm install multer --save 


奶奶 线 


第 一 个 Express 框架 实例 


接 下 来 我 们 使 用 Express 框架 来 输出 "Hello World"。 


以 下 实例 中 我 们 引入 了 express 模块 ， 并 在 客户 端 发 起 请 求 后 ， 响 应 "Hello World" 字符 串 。 


创建 express_demo.js 文件 ， 代 码 如 下 所 示 : 


//express_demo.js 文件 
var express = require('express ' ) ; 
var app = express(); 


app.get('/', function (req, res) { 
res.send('Hello World'); 
}) 


var server = app.listen(8081, function () { 


var host 
var port 


= server.address().address 
= server.address().port 


console.1og(" 应 用 实例 ， 访 问 地址 为 http://%s:%s"，host, port) 


}) 


执行 以 上 代码 : 


$ node express_demo.js 
应 用 实例 ， 访 问 地 址 为 http://0.0.0.0:8081 


在 浏览 器 中 访问 http:/127.0.0.1:8081， 结 果 如 下 图 所 示 : 


请 求 和 响应 
Express 应 用 使 用 回调 函数 的 参数 : request 和 response 对 象 来 处理 请 求 和 响应 的 数据 。 


app.get('/', function (req, res) { 
2 


}) 


request 和 response 对 象 的 具体 介绍 : 


Request 对 象 - request 对 象 表示 HTTP 请 求 ， 包 含 了 请 求 查询 字符 串 ， 参 数 ， 内 容 ，HTTP 
头 部 等 属性 。 常 见 属性 有 : 


1. req.app : 当 callback 为 外 部 文件 时 ， 用 req.app 访 问 express 的 实例 
2. red.baseUrl : 获取 路 由 当前 安装 的 URL 路 径 

3. req.body / req.cookies : 获得 「 请 求 主 体 | / Cookies 

4. req.fresh / req.stale : 判断 请 求 是 否 还 「 新 鲜 」 
5.，req.hostname / req.ip : 获取 主机 名 和 IP 地 址 

6，req.originalUrl : 获取 原始 请 求 URL 

7. req.params : 获取 路 由 的 parameters 


8. req.path : 获取 请 求 路 径 

9. req.protocol : 获取 协议 类 型 

10. req.query : 获取 URL 的 查询 参数 串 

11. req.route : 获取 当前 匹配 的 路 由 

12. req.subdomains : 获取 子 域名 

13. req.accpets () : 检查 请 求 的 Accept 头 的 请 求 类 型 

14. req.acceptsCharsets / req.acceptsEncodings / redq.acceptsLanguages 
15. req.get () : 获取 指定 的 HTTP 请 求 头 

6. req.is () : 判断 请 求 头 Content-Type 的 MIME 类 型 


一 人 


Response 对 象 - response 对 象 表示 HTTP 响应 ， 即 在 接收 到 请 求 时 向 客户 端 发 送 的 HTTP 
响应 数据 。 常 见 属性 有 : 


. res.app : 同 req.app 一 样 

. res.append () : 追加 指定 HTTP 头 

. res.set () 在 res.append () 后 将 重 置 之 前 设置 的 头 
.res.cookie (name，value [，option]) : 设置 Cookie 


.res.clearCookie () : 清除 Cookie 
. res.download () : 传送 指定 路 径 的 文件 
. res.get () : 返回 指定 的 HTTP 头 
.Tres.json () : 传送 JSON 响 应 
10. res.jsonp () : 传送 JSONP 响 应 
11. res.location () : 只 设置 响应 的 Location HTTP 头 ， 不 设置 状态 码 或 者 close response 
12. res.redirect () : 设置 响应 的 Location HTTP 头 ， 并 且 设 置 状 态 码 302 
13. res.send () : 传送 HTTP 响 应 
14. res.sendFile (path [，options] [，fn]) : 传送 指定 路 径 的 文件 -会 自动 根据 文件 
extension 设 定 Content-Type 
15. res.set () : 设置 HTTP 头 ， 传 人 object 可 以 一 次 设置 多 
16. res.status () : 设置 HTTP 状 态 码 
17. res.type () : 设置 Content-Type 的 MIME 类 型 


路 由 


我 们 已 经 了 解 了 HTTP 请 求 的 基本 应 用 ， 而 路 由 决定 了 由 谁 (指定 脚本 ) 去 响应 客户 端 请 求 。 


1 
2 
3 
4 
5. opition: domain / expires / httpOnly / maxAge / path / secure / signed 
6 
7 
8 
9 


> 


头 


在 HTTP 请 求 中 ， 我 们 可 以 通过 路 由 提取 出 请 求 的 URL 以 及 GET/POST 参 数 。 
接 下 来 我 们 扩展 Hello World， 添 加 一 些 功 能 来 处 理 更 多 类 型 的 HTTP 请 求 。 


创建 express_demo2.js 文件 ， 代 码 如 下 所 示 : 


var express = require('express'); 
var app = express(); 


// 主页 输出 "Hello World" 
app.get('/', function (req, res) { 
console.1og(" 主 页 GET 请 求 "); 

res.send('Hello GET'); 
yy 


// ”POST 请 求 

app.post('/', function (req, res) { 
console.1og(" 主 页 POST 请 求 ")，; 
res.send('Hello POST ' ) ; 

}) 


// ” /del user 页 面 响 应 

app.delete('/del user', function (req, res) { 
console.1l0og("/del_user 响应 DELETE 请 求 "); 
res.send(' 删 除 页 面 ' ); 

}) 


// /list_user 页 面 GET 请 求 

app.get('/list_ user', function (req, res) { 
console.log("/list_user GET 请 求 "); 
res.send(' 用 户 列表 页 面 ' ) ; 

}) 


// 对 页 面 abcd，abxcd，ab123cd， 等 响应 GET 请 求 
app.get('/ab*cd', function(req, res) { 
console.1og("/ab*cd GET 请 求 "); 
res.send( ' 正 则 匹配 ' ) ; 
}) 


var server = app.listen(8081, function () { 


var host 
var port 


server.address().address 
server.address().port 


console.1og(" 应 用 实例 ， 访 问 地 址 为 http://%s:%s"，host, port) 


}) 
执行 以 上 代码 : 


$ node express_demo2 ,js 
应 用 实例 ， 访 问 地 址 为 http://0.0.0.0:8081 


接 下 来 你 可 以 党 试 访问 http://127.0.0.1:8081 不 同 的 地 址 ， 查 看 效果 。 


在 浏览 器 中 访问 http:/127.0.0.1:808TWlist_user， 结 果 如 下 图 所 示 : 


在 浏览 器 中 访问 http:/127.0.0.1:8081/abcd， 结 果 如 下 图 所 示 : 


在 浏览 器 中 访问 http:/127.0.0.1:8081/abcdefg， 结 果 如 下 图 所 示 : 


静态 文件 


Express 提供 了 内 置 的 中 间 件 express.static 来 设置 静态 文件 如 : 图 片 ， CSS, JavaScript 
等 。 


你 可 以 使 用 express.static 中 间 件 来 设置 静态 文件 路 径 。 例 如 ， 如 果 你 将 图 片 ， CSS， 
JavaScript 文件 放 在 public 目录 下 ， 你 可 以 这 么 写 : 


app.use(express.static('public')); 


我 们 可 以 到 public/images 目录 下 放 些 图 片 ,如 下 所 示 : 


node_modules 

Server .js 

public/ 

public/images 
public/images/1l0go.png 


让 我 们 再 修改 下 "Hello Word" 应 用 添加 处 理 静 态 文件 的 功能 。 


创建 express_demo3.js 文件 ， 代 码 如 下 所 示 : 


var express = require('express ' ) ; 
var app = express(); 


app.use(express,Sstatic('public'))， 

app.get('/', function (req, res) { 
res.send('Hello World'); 

}) 


var server = app.listen(8081, function () { 


var host 
var port 


server.address().address 
server.address().port 


console,1og(" 应 用 实例 ， 访 问 地址 为 http://%s:%s"，host, port) 
}) 


执行 以 上 代码 : 


$ node express_demo3.js 
应 用 实例 ， 访 问 地 址 为 http://0.0.0.0:8081 


执行 以 上 代码 : 


在 浏览 器 中 访问 http://127.0.0.1:8081/images/logo.png (本 实例 采用 了 菜 乌 教 程 的 logo) ， 
结果 如 下 图 所 示 : 


GET 方法 


以 下 实例 演示 了 在 表单 中 通过 GET 方法 提交 两 个 参数 ， 我 们 可 以 使 用 serverjs 文件 内 的 
process_get 路 由 器 来 处 理 输入 : 


index.htm 文件 代码 如 下 : 


<html> 

<body> 

<form action="http://127.0.0.1:8081/process _ get" method="GET"> 
First Name: <input type="text" name="first_name"> <br> 


Last Name: <input type="text" name="last_name"> 
<input type="submit" value="Submit"> 

</form> 

</body> 

</html> 


server.js 文件 代码 如 下 : 


Var express = require('express'); 
var app = express(); 


app.use(express.static('public')); 


app.get('/index.htm', function (req, res) { 
res.sendFile( _ dirname + "/" + "index.htm" ); 
}) 


app.get('/process get', function (req, res) { 


// 输出 JSON 格式 

response = { 
first_name:req.query.first_name, 
last_name:req.query.last_name 

}; 

console.1log(response); 

res.end(JSON.stringify(response)); 


}) 


var server = app.listen(8081, function () { 


var host 
var port 


server.address().address 
server.address().port 


console.10g(" 应 用 实例 ， 访 问 地 址 为 http://%s:%s"，host, port) 


}) 
执行 以 上 代码 : 
node server .js 


应 用 实例 ， 访 问 地 址 为 http://0.0.0.0:8081 


浏览 器 访问 http://127.0.0.1:8081/index.htm， 如 图 所 示 : 


现在 你 可 以 向 表单 输入 数据 ， 并 提交 ， 如 下 演示 : 


POST 方法 


以 下 实例 演示 了 在 表单 中 通过 POST 方法 提交 两 个 参数 ， 我 们 可 以 使 用 serverjs 文件 内 的 
process_get 路 由 器 来 处 理 输入 : 


index.htm 文件 代码 修改 如 下 : 


<html> 

<body> 

<form action="http://127.0.0.1:8081/process_ post" method="POST"> 
First Name: <input type="text" name="first_name"> <br> 


Last Name: <input type="text" name="last_name"> 
<input type="submit" value="Submit"> 

</form> 

</body> 

</html> 


server.js 文件 代码 修改 如 下 : 


Var express = require('express'); 
var app = express(); 
Var bodyParser = require('body-parser'); 


// 创建 application/x-www-form-urlencoded 编码 解析 
var urlencodedParser = bodyParser.urlencoded({ extended: false }) 


app.use(express.static('public')); 


app.get('/index.htm', function (req, res) { 
res.sendFile( _ dirname + "/" + "index.htm" ); 


}) 


app.post('/process_post', urlencodedParser, function (req, res) { 


// 输出 JSON 格式 

response = { 
first_name:req.body.first_name, 
last_name:req.body.last_name 

}; 

console.log(response); 

res.end(JSON.stringify(response)); 


}) 


var server = app.listen(8081, function () { 


var host 
var port 


server.address().address 
server.address().port 


console.10og(" 应 用 实例 ， 访 问 地 址 为 http://%s:%s"，host, port) 


}) 


执行 以 上 代码 : 


$ node express_demo ,js 
应 用 实例 ， 访 问 地 址 为 http://0.0.0.0:8081 


浏览 器 访问 http://127.0.0.1:8081/index.htm， 如 图 所 示 : 


现在 你 可 以 向 表单 输入 数据 ， 并 提交 ， 如 下 演示 : 


文件 上 传 


以 下 我 们 创建 一 个 用 于 上 传 文件 的 表单 ， 使 用 POST 方法 ， 表 单 enctype 属性 设置 为 
multipart/form-data。 


index.htm 文件 代码 修改 如 下 : 


<html> 

<head> 

<title> 文 件 上 传 表单 </title> 

</head> 

<body> 

<h3> 文 件 上 传 : </h3> 

选择 一 个 文件 上 传 : <br /> 

<form action="/file upload" method="post" enctype="multipart/form-data"> 
<input type="file" name="image" size="50" /> 
<br /> 

<input type="submit" value=" 上 传 文件 " /> 
</form> 

</body> 

</html> 


serverjs 文件 代码 修改 如 下 : 


var express = require('express ' ) ; 
var app = express(); 
var fs = require("fs"),; 


var bodyParser = require('body-parser'); 
var multer = require('multer'); 


app.use(express.static('public')); 
app.use(bodyParser.urlencoded({ extended: false })); 
app.use(multer({ dest: '/tmp/'}).array('image')); 


app.get('/index.htm', function (req, res) { 
res.sendFile( _ dirname + "/" + "index.htm" ); 


}) 
app.post('/file _ upload', function (req, res) { 
console.log(req.files[0]); // 上 传 的 文件 信息 


var des file = _ dirname + "/" + req.files[0].originalname; 
fs.readFile( req.files[0].path, function (err, data) { 
fs.writeFile(des file, data, function (err) { 
if( err ){ 
console.log( err ); 
}elsef{ 
response = { 
message:'File uploaded successfully', 
filename:req.files[0].originalname 


】 
} 
console.log( response ); 
res.end( JSON.stringify( response ) ); 
}); 
}); 
}) 


var server = app.listen(8081, function () { 


var host 
var port 


server.address().address 
server.address().port 


console,1og(" 应 用 实例 ， 访 问 地址 为 http://%s:%s"，host, port) 


}) 
执行 以 上 代码 : 
$ node express_demo.js 


应 用 实例 ， 访 问 地 址 为 http://0.0.0.0:8081 


浏览 器 访问 http:/127.0.0.1:808TWindex.htm， 如 图 所 示 : 


现在 你 可 以 向 表单 输入 数据 ， 并 提交 ， 如 下 演示 : 


Cookie 管理 


我 们 可 以 使 用 中 间 件 向 Node.js 服务 器 发 送 cookie 信息 ， 以 下 代码 输出 了 客户 端 发 送 的 
cookie 信息 : 

// express_cookie.js 文件 

Var express = require('express') 

var cookieParser = require('cookie-parser') 


var app = express() 
app.use(cookieParser()) 


app.get('/', function(req, res) { 
console.log("Cookies: ", req.cookies) 


}) 


app.listen(8081) 
执行 以 上 代码 : 
$ node express_demo.js 


现在 你 可 以 访问 http://127.0.0.1:8081 并 查看 终端 信息 的 输出 ， 如 下 演示 : 


Node.js RESTful API 


什么 是 REST? 
RREST 即 表述 性 状态 传递 (英文 : Representational State Transfer， 简 称 REST) 是 Roy 
Fielding 博 士 在 2000 年 他 的 博士 论文 中 提出 来 的 一 种 软件 架构 风格 。 


表述 性 状态 转移 是 一 组 架构 约束 条 件 和 原则 。 满 足 这 些 约束 条 件 和 原则 的 应 用 程序 或 设计 就 
是 RESTful。 需 要 注意 的 是 ，REST 是 设计 风格 而 不 是 标准 。REST 通 常 基于 使 用 HTTP， 
URI， 和 XML 〈 标 准 通用 标记 语言 下 的 一 个 子 集 ) 以 及 HTML (标准 通用 标记 语言 下 的 一 
用 ) 这 些 现 有 的 广泛 流行 的 协议 和 标准 。REST 通常 使 用 JSON 数据 格式 。 


HTTP 方法 
以 下 为 REST 基本 架构 的 四 个 方法 : 
。 GET - 用 于 获取 数据 。 
。 PUT - 用 于 添加 数据 。 
。 DELETE - 用 于 删除 数据 。 
。 POST - 用 于 更 新 或 添加 数据 。 


RESTful Web Services 


Web service 是 一 个 平台 独立 的 ， 低 耦合 的 ， 自 包含 的 、 基 于 可 编程 的 web 的 应 用 程序 ， 可 使 
用 开放 的 XML (标准 通用 标记 语言 下 的 一 个 子 集 ) 标准 来 描述 、 发 布 、 发 现 、 协 调和 配置 这 
些 应 用 程序 ， 用 于 开发 分 布 式 的 互 操作 的 应 用 程序 。 


基于 REST 架构 的 Web Services 即 是 RESTful。 


由 于 轻 量 级 以 及 通过 HTTP 直接 传输 数据 的 特性 ，Web 服务 的 RESTful 方法 已 经 成 为 最 常 
的 替代 方法 。 可 以 使 用 各 种 语言 (比如 Java 程序 、Perl、Ruby、Python、PHP 和 
Javascript[ 包 括 Ajax]) 实现 客户 端 。 


RESTful Web 服务 通常 可 以 通过 自动 客户 端 或 代表 用 户 的 应 用 程序 访问 。 但 是 ， 这 种 服务 的 
简便 性 让 用 户 能 够 与 之 直接 交互 ， 使 用 它们 的 Web 浏览 器 构建 一 个 GET URL 并 读 取 返回 的 
内 容 。 


更 多 介绍 ， 可 以 查看 : RESTful 架构 详解 


创建 RESTful 


首先 ， 创 建 一 个 json 数据 资源 文件 users.json， 内 容 如 下 : 


{ 

"useri” ; { 
"name" : "mahesh", 
"password" : "password1", 
"profession" : "teacher", 
pate oil 

}, 

"USEr2™ 攻 
"name" : "suresh", 
"password" : "password2", 
"profession" : "librarian", 
tte | 2 

}, 

"UsSer3" { 
"name" : "ramesh", 
"password" : "password3", 
"profession" : "clerk", 
ice ee 

} 

} 


基于 以 上 数据 ， 我 们 创建 以 下 RESTful API : 


序号 URI 
1 listUsers 
2 addUser 
3 deleteUser 
4 :id 


获取 用 户 列 表 : 


HTTP 方法 


GET 
POST 
DELETE 
GET 


2 
二 


JSON 字符 串 
JSON 字符 串 


2 
= 


结果 
显示 所 有 用 户 列表 
添加 新 用 户 
删除 用 户 


显示 用 户 详细 信息 


以 下 代码 ， 我 们 创建 了 RESTful APlI listUsers， 用 于 读 取 用 户 的 信息 列表 ， server.js 文件 代 


码 如 下 所 示 : 


var express = require('express ' ) ; 
var app = express(); 
var fs = require("fs"),; 


app.get('/listUsers', function (req, res) { 


fs.readFile( _ dirname + "/" + "Users.json", 


console.1og( data ); 
res.end( data ); 
}); 
}) 


var server = app.listen(8081, function () { 


var host 
var port 


server.address().address 
server.address().port 


console,1og(" 应 用 实例 ， 访 问 地址 为 http://%s:%s"，host, port) 


}) 


接 下 来 执行 以 下 命令 : 


$ node server ,js 
应 用 实例 ， 访 问 地 址 为 http://0.0.0.0:8081 


在 浏览 器 中 访问 http://127.0.0.1:8081/listUsers， 结 果 如 下 所 示 : 


{ 

"userL 
"name" "mahesh", 
"password" "password1", 
"profession" "teacher", 
cols a[ 

}, 

"User2" :; { 
"name" "suresh", 
"password" "password2", 
"profession" "Jibrarian", 
liol ee 

}, 

Muser3 人 
"name" "ramesh", 
"password" "password3", 
"profession" Clenrnk 
和 3 

} 

} 


添加 用 户 


以 下 代码 ， 我 们 创建 了 RESTful APl addUser， 
如 下 所 示 : 


用 于 添加 新 的 用 户 数 据 ， 


'utf8', function (err, data) { 


server.js 文件 代码 


var express = require('express ' ) ; 
var app = express(); 


var fs = require("fs"); 
// 添 加 的 新 用 户 数据 
var user = { 
USeI 
"name" "mohit", 
"password" "password4", 
"profession" "teacher", 
rol :A 
} 
} 


app.get('/addUser', function (req, 
// 读 取 已 存在 的 数据 
fs.readFile( _ dirname + "/" + "Users.json", 
data = JSON.parse( data ); 
data["user4"] = user["user4"]; 
console.1og( data ); 
res.end( JSON.stringify(data)); 
}); 
}) 


Var SerVer es 


res) { 


app.listen(8081, function () { 


var host = 
var port = 


server.address().address 
server.address().port 


console.1og(" 应 用 实例 ， 访 问 地 址 为 http://%s:%s"，host,，, 


}) 


接 下 来 执行 以 下 命令 : 


$ node server.js 
应 用 实例 ， 访 问 地 址 为 http://0.90.0.0:8081 


在 浏览 器 中 访问 http://127.0.0.1:8081/addUsers，: 


{ useri1: 

{ name: 'mahesh', 
password: "password1 '， 
profession: 'teacher', 
oto sl ey 

USer2 : 

{ name: "Suresh '， 
password: "password2 '， 
profession: 'librarian', 
atolH 2 gy 

user3: 

{ name: 'ramesh', 
password: 'password3', 
profession: 'clerk', 
aq 

user4: 

{ name: "mohit '， 
password: 'password4', 
profession: 'teacher', 
id: 4 } 

} 


'utf8', function (err, data) { 


port) 


吉 果 如 下 所 示 : 


以 下 代码 ， 我 们 创建 了 RESTful APl :id (用 户 id) ， 
server.js 文件 代码 如 下 所 示 : 


Var express = require('express'); 
var app = express(); 
var fs = require("fs"),; 


app.get('/:id', function (req, res) { 
// 首先 我 们 读 取 已 存在 的 用 户 
fs.readFile( _ dirname + "/" + "Users.json", 
data = JSON.parse( data ); 
var user = data["user" + req.params.id] 
console.log( user ); 
res.end( JSON.stringify(user)); 
}); 
}) 


var server = app.listen(8081, function () { 


var host = server.address().address 
var port = server.address().port 


用 于 读 取 指定 用 户 的 详细 信息 ， 


'utf8', function (err, data) { 


console.1l0g(" 应 用 实例 ， 访 问 地 址 为 http://%s:%s"，host, port) 


}) 


接 下 来 执行 以 下 命令 : 


$ node server .js 
应 用 实例 ， 访 问 地 址 为 http://0.0.0.0:8081 


在 浏览 器 中 访问 http:/127.0.0.1:8081/2， 结 果 如 下 所 示 : 


{ 
"name":"suresh", 
"password":"password2", 
"profession":"librarian", 
Tl 2 

} 


删除 用 户 


以 下 代码 ， 我 们 创建 了 RESTful API deleteUser， 
中 ， 用 户 id 为 2，serverjs 文件 代码 如 下 所 示 : 


用 于 删除 指定 用 户 的 详细 信息 ， 以 下 实例 


var express = require('express ' ) ; 
var app = express(); 
var fs = require("fs"),; 


var id = 2; 
app.get('/deleteUser', function (req, res) { 


// First read existing users. 

fs.readFile( _ dirname + "/" + "Users.json", 'utf8', function (err, data) { 
data = JSON.parse( data ); 
delete data["user" + 2]; 


console.1og( data ); 
res.end( JSON.stringify(data)); 
}); 
}) 


var server = app.listen(8081, function () { 


var host = server.address().address 
var port = server.address().port 
console.1og(" 应 用 实例 ， 访 问 地 址 为 http://%s:%s"，host, port) 


}) 


接 下 来 执行 以 下 命令 : 


$ node server ,js 
应 用 实例 ， 访 问 地 址 为 http://0.0.0.0:8081 


在 浏览 器 中 访问 http:/127.0.0.1:8081/deleteUser， 结 果 如 下 所 示 : 


{ user1l: 

{ name: "mahesh '， 
password: "password1 '， 
profession: 'teacher', 
开路) 天) 

USer3 : 

{ name: "ramesh '， 
password: "password3 '， 
profession: "clerk '， 
2 


Node.js 多 进程 
我 们 都 知道 Node.js 是 以 单线 程 的 模式 运行 的 ， 但 它 使 用 的 是 事件 驱动 来 处 理 并 发 ， 这 样 有 
助 于 我 们 在 多 核 cpu 的 系统 上 创建 多 个 子 进 程 ， 从 而 提高 性 能 。 


每 个 子 进 程 总 是 带 有 三 个 流 对 象 : child.stdin, child.stdout 和 child.stderr。 他 们 可 能 会 共享 父 
进程 的 stdio 流 ， 或 者 也 可 以 是 独立 的 被 导 流 的 流 对 象 。 


Node 提供 了 child_process 模块 来 创建 子 进程 ， 方 法 有 : 


。 exec - child_process.exec 使 用 子 进 程 执行 命 售 ， 缓 存 子 进程 的 输出 ， 并 将 子 进 程 的 输出 
以 回调 画 数 参数 的 形式 返回 。 

。 spawn - child_process.spawn 使 用 指定 的 命令 行 参 数 创建 新 线程 。 

fork - child_process.fork 是 spawn() 的 特殊 形式 ， 用 于 在 子 进程 中 运行 的 模块 ， 如 


fork('./son.js') 相当 于 spawn('node', ['./son.js1) 。 与 spawn 方 法 不 同 的 是 ，fork 会 在 父 进 
程 与 子 进程 之 间 ， 建 立 一 个 通信 管道 ， 用 于 进程 之 间 的 通信 。 


exec() 方法 

child_process.exec 使 用 子 进程 执行 命 依 ， 缓 存 子 进程 的 输出 ， 并 将 子 进程 的 输出 以 回调 本 数 
参数 的 形式 返回 。 

语法 如 下 所 示 : 


child_process.exec(command[, options], callback) 


参数 
参数 说 明 如 下 : 
command : 字符 串 ， 将 要 去 行 的 命令， 参数 使 用 空格 隔 开 
options : 对 象 ， 可 以 是 : 
。 cwd ， 字 符 串 ， 子 进程 的 当前 工作 目录 
。 env， 对 象 环境 变量 键 值 对 
。 encoding ， 字 符 串 ， 字 符 编 码 (默认 : 'utf8') 
。 shell ， 字 符 串 ， 将 要 执行 命令 的 Shell (默认 : 在 UNIX 中 为 /binysh ， 在 Windows 中 


为 cmd.exe ， Shell 应 当 能 识别 -c 开关 在 UNIX 中 ,或 /s vc 在 Windows 中 。 在 
Windows 中 ， 命 令 行 解析 应 当 能 兼容 cmd.exe ) 


。 timeout， 数 字 ， 超 时 时 间 (默认 : 0) 

。 maxBuffer， 数 字 ， 在 stdout 或 stderr 中 人 允许 存在 的 最 大 缓冲 (二进制 ) ， 如 果 超 出 那 
么 子 进程 将 会 被 杀 死 (默认 : 200*1024) 

。 killSignal ， 字 符 串 ， 结 束 信号 (默认 : 'SIGTERM') 

。 uid， 数 字 ， 设 置 用 户 进程 的 ID 

。 gid， 数 字 ， 设 置 进程 组 的 ID 


callback : 回调 函数 ， 包 含 三 个 参数 error stdout 和 stderr。 


exec() 方法 返回 最 大 的 缓冲 区 ， 并 等 待 进程 结束 ， 一 次 性 返回 缓冲 区 的 内 容 。 


实例 
让 我 们 创建 两 个 js 文件 supportjs 和 masterjs。 


support.js 文件 代码 : 


console.1og(" 进 程 " + process.argv[2] + " 执行。" ) ; 


master.js 文件 代码 : 


const fs = require('fs'); 
const child_process = require('child_process'); 


for(var i=0; i<3; i++) { 
var workerProcess = child_process.exec('node support.js '+i 
function (error, stdout, stderr) { 
if (error) { 
console.log(error.stack); 
console.log('Error code: '+error.code); 
console.log('Signal received: '+error.signal); 


} 
console.log('stdout: ' + stdout); 
console.log('stderr: ' + stderr); 


}); 


workerProcess.on('exit', function (code) { 
console.10g(' 子 进程 已 退出 ， 退 出 码 '+code); 
}); 
} 


执行 以 上 代码 ， 输 出 结果 为 : 


$ node master ,js 

子 进 程 已 退出 ， 退 出 码 0 
stdout: 进程 1 执行 。 
stderr: 

子 进程 已 退出 ， 退 出 码 0 
stdout: 进程 0 执行 。 
stderr: 

子 进程 已 退出 ， 退 出 码 0 
stdout: 进程 2 执行 。 


stderr: 


spawn/() 方法 
child_process.spawn 使 用 指定 的 命令 行 参数 创建 新 线程 ， 语 法 格式 如 下 : 


child_process.spawn(command[, args][, options]) 


参数 说 明 如 下 : 

command : 将 要 运行 的 命令 
args : Array 字符 串 参 数 数组 
options Object 


。 cwd String 子 进 程 的 当前 工作 目录 

。 env Object 环境 变量 键 值 对 

。 stdio Array|String 子 进 程 的 stdio 配置 

。 detached Boolean 这 个 子 进 程 将 会 变 成 进程 组 的 领导 
。 uid Number 设置 用 户 进程 的 ID 

。 gid Number 设置 进程 组 的 ID 


spawn() 方法 返回 流 (stdout & stderr)， 在 进程 返回 大 量 数据 时 使 用 。 进 程 一 旦 开始 执行 时 
spawn() 就 开始 接收 响应 。 


实例 
让 我 们 创建 两 个 js 文件 supportjs 和 masterjs。 


support.js 文件 代码 : 


console.log(" 进 程 " + process.argv[2] + " 执行。" ); 


master.js 文件 代码 : 
const fs = require('fs'); 
const child_process = require('child_process'); 


for(var i=0; i<3; i++) { 
var workerProcess = child_process.spawn('node', ['support.js', i]); 


workerProcess.stdout.on('data', function (data) { 


console.log('stdout: ' + data); 

}); 

workerProcess.stderr.on('data', function (data) { 
console.log('stderr: ' + data); 

}); 


workerProcess.on('close', function (code) { 
console.10g(' 子 进程 已 退出 ， 退 出 码 '+code); 


}); 


执行 以 上 代码 ， 输 出 结果 为 : 


$ node master.js stdout: 进程 0 执行 。 


子 进程 已 退出 ， 退 出 码 0 
stdout: 进程 1 执行 。 


子 进程 已 退出 ， 退 出 码 0 
stdout: 进程 2 执行 。 


子 进 程 已 退出 ， 退 出 码 0 


fork 方法 
child_process.fork 是 spawn() 方法 的 特殊 形式 ， 用 于 创建 进程 ， 语 法 格式 如 下 : 


child_process.fork(modulePath[, args][, options]) 


参数 说 明 如 下 : 

modulePath : String， 将 要 在 子 进 程 中 运行 的 模块 
args : Array 字符 串 参 数 数组 

options : Object 


。 cwd String 子 进程 的 当前 工作 目录 

e。 env Object 环境 变量 键 值 对 

。 execPath String 创建 子 进 程 的 可 执行 文件 

。 execArgv Array 子 进 程 的 可 执行 文件 的 字符 串 参数 数组 (默认 : process.execArgv) 


。 silent Boolean 如 果 为 true ， 子 进程 的 stdin ， stdout 和 stderr 将 会 被 关联 至 父 进 
程 ， 否 则 ， 它 们 将 会 从 父 进程 中 继承 。 (默认 为 : false ) 

。 uid Number 设置 用 户 进程 的 ID 

。 gid Number 设置 进程 组 的 ID 


返回 的 对 象 除 了 拥有 ChildProcess 实 例 的 所 有 方法 ， 还 有 一 个 内 建 的 通信 信道 。 
h3> 实 例 


让 我 们 创建 两 个 js 文件 supportjs 和 masterjs。 


support.js 文件 代码 : 


console.1log(" 进 程 " + process.argv[2] + " 执行。" ); 


master.js 文件 代码 : 


const fs = require('fs'); 
const child_process = require('child process'); 


for(var i=0; i<3; i++) { 
var worker_process = child_process.fork("support.js", [i]); 


worker_process.on('close', function (code) { 

console.10g(' 子 进程 已 退出 ， 退 出 码 ' + code); 
}); 
} 


执行 以 上 代码 ， 输 出 结果 为 : 


$ node master ,js 
进程 0 执行 。 

子 进程 已 退出 ， 退 出 码 9 
进程 1 执行 。 

子 进程 已 退出 ， 退 出 码 9 
进程 2 执行 。 

子 进程 已 退出 ， 退 出 码 9 


Node.js JXcore 打包 


Node.js 是 一 个 开放 源 代 码 、 跨 平台 的 、 用 于 服务 器 端 和 网 络 应 用 的 运行 环境 。 


JXcore 是 一 个 支持 多 线程 的 Node.js 发 行 版 本 ， 基 本 不 需要 对 你 现 有 的 代码 做 任何 改动 就 可 
以 直接 线程 安全 地 以 多 线程 运行 。 


但 我 们 这 篇 文章 主要 是 要 教 大 家 介绍 JXcore 的 打包 功能 。 


ch 


JXcore 安装 


下 载 JXcore 安装 包 ， 并 解压 ， 在 解压 的 的 目录 下 提供 了 jx 二 进 制 文件 命 舍 ， 接 下 来 我 们 主 
要 使 用 这 个 命令 。 


步骤 1、 下 载 


下 载 JXcore 安装 包 http://jxcore.com/downloads/， 你 需要 根据 你 自己 的 系统 环境 来 下 载 安装 
包 。 


1、Window 平台 下 载 : Download， 


2、Linux/OSX 下 载 安 装 命 售 ， 直 接 下 载 解压 包 下 的 jx 二 进 制 文件 拷贝 到 /usrbin 目录 下 : 


$ wget https://s3.amazonaws.com/nodejx/jx_rh64.zip 
$ unzip jx_rh64.zip 
$ cp jx_rh64/jx /usr/bin 


将 /usr/bin 添加 到 PATH 路 径 中 : 


$ export PATH=$PATH:/usr/bin 


以 上 步骤 如 果 操 作 正 确 ， 使 用 以 下 命 舍 ， 会 输出 版 本 号 信息 : 


$ jx --version 
vO.10.32 


乌 代 码 


例如 ， 我 们 的 Node.js 项 目 包含 以 下 几 个 文件 ， 其 中 index.js 是 主 文件 : 


drwxr-xr-x root root 4096 Nov 13 12:42 images 
-rwxr-xr-x root root 30457 Mar 6 12:19 index.htm 
-rwxr-xr-x root root 30452 Mar 1 12:54 index.js 


drwxr-xr-x 2 
drwxr -xr-x 
drwxr -xr-x 


root root 4096 Jan 15 03:48 node_modules 
root root 4096 Mar 21 06:10 scripts 
root root 4096 Feb 15 11:56 style 


DDoPPD 


接 下 来 我 们 使 用 jx 命令 打包 以 上 项 目 ， 并 指定 index.js 为 Node.js 项 目的 主 文件 : 


$ jx package index.js index 


以 上 命令 执行 成 功 ， 会 生成 以 下 两 个 文件 : 
。 index.jxp 这 是 一 个 中 间 件 文件 ， 包 含 了 需要 编译 的 完整 项 目 信 息 。 


。 index.jx 这 是 一 个 完整 包 信 息 的 二 进 制 文 件 ， 可 运行 在 客户 端 上 。 


载 人 JX 文件 
我 们 使 用 jx 命令 打包 项 目 : 


$ node index.js command_line_arguments 


使 用 JXcore 编译 后 ， 我 们 可 以 使 用 以 下 命令 来 执行 生成 的 jx 二 进 制 文件 : 


$ jx index.jx command_line_arguments 


更 多 JXcore 功能 特性 你 可 以 参考 官网 : hitp://jxcore.com/。 


Wordpress 教 程 


Wordpress 介绍 


WordPress 是 一 个 开源 内 容 管 理 系统 (CMS) ， 它 人 允许 用 户 构建 动态 网 站 和 博客 。 
WordPress 是 基于 PHP 和 MySQL (用 于 存储 数据 ) 。WordPress 是 最 流行 的 博客 系统 ， 在 网 
络 上 从 后 端 CMS 和 组 件 允 许 更 新 ， 定 制 和 管理 网 站 。 


什么 是 内 容 管 理 系统 (CMS) ? 


内 容 管理 系统 (CMS) 是 一 个 软件 ， 它 会 将 所 有 的 数据 ， 如 文本 ， 图 片 ， 音 乐 ， 文 档 等 ， 在 
你 的 网 站 上 管理 提供 。 它 可 以 帮助 编辑 ， 发 布 和 修改 网 站 内 容 。 


历史 


WordPress 是 由 马 特 :查尔斯 : 穆 伦 维 格 和 Mike 最 初 发 布 于 2003 年 5 月 27 日 。WordPress 在 
2009 年 10 月 宣布 开放 源码 。 


特性 


。 用 户 管理 : 它 人 允许 管理 用 户 信息 ， 例 如 更 换 到 (订阅 者 ， 贡 献 者 ， 作 者 ， 编 辑 或 管理 
员 ) 的 用 户 角色 ， 创 建 或 删除 用 户 ， 更 改 密码 和 用 户 信息 。 用 户 管理 人 员 的 主要 部 分 是 
身份 验证 。 


。 媒体 管理 : 它 用 于 管理 媒体 文件 和 文件 夹 的 工具 ， 您 可 以 轻松 地 上 传 ， 组 织 和 管理 网 站 
上 的 媒体 文件 。 


。 主题 系统 : 它 允 许 修改 网 站 视图 和 功能 。 它 包括 图 片 ， 样 式 表 ， 模 板 文件 和 自 定义 页 
面 。 


。 扩展 与 插件 : 根据 用 户 需要 ， 有 好 多 插件 都 可 以 提供 自 定义 的 功能 和 特性 。 
。 搜索 引擎 优化 : 它 提 供 了 多 种 搜索 引擎 优化 《SEO) 工具， 这 使 得 SEO 更 简单 。 
。 多 语言 : 它 允 许 翻 译 所 有 的 内 容 到 用 户 选择 的 语言 。 


。 导入 器 : 它 人 允许 导入 发 布 形 式 的 数据 。 它 导入 自 定义 文件 ， 评 论 ， 帖 子 页 和 标签 。 


Wordpress 优 势 


。 它 是 一 个 开源 平台 ， 并 免费 提供 。 


。 CSS 文 件 可 根据 设计 根据 用 户 需 要 进行 修改 。 


。 有 许多 插件 和 人 免费 提供 的 模板 。 用 户 可 以 按 需 要 自 定义 各 种 插件 。 


。 它 使 用 所 见 即 所 得 的 编辑 器 来 编辑 内 容 ( 您 看 到 的 就 是 得 到 的 用 户 界面 ， 人 允许 用 户 直接 
操作 的 文件 布局 ， 而 无 需 布 局 命令 ) 。 


。 媒体 文件 可 以 很 容易 并 迅速 地 进行 上 载 /上 传 。 

。 它 提供 了 多 种 搜索 引擎 优化 〈SEO) 工具 ， 这 使 得 SEO 简单 。 

。 根据 用 户 的 需要 定制 是 容易 的 。 

。 它 允 许 用 户 对 网 站 如 管理 员 ， 作 者 ， 编 辑 和 撰 稿 人 创建 不 同 的 角色 。 


Wordpress 缺 点 


。 使 用 多 个 插件 可 以 使 网 站 加 载 和 运行 沉重 。 
。 PHP 知 识 是 必须 的 ， 特 别 在 做 修改 或 改变 WordPress 网 站 时 。 


e。 有时， 软件 需要 更 新 ， 以 保持 WordPress 的 最 新 在 当前 浏览 器 和 移动 设备 可 用 。 
WordPress 的 版 本 更 新 会 导致 数据 丢失 ， 因 此 需要 网 站 的 各 份 副 本 。 


。 修改 和 格式 化 图 形 图 像 和 表格 比较 困难 。 


Wordpress 安 装 - Wordpress 教 程 


WordPress 系 统 要 求 


。 数据 库 : MySQL 5.0 + 
。 Web 服 务 器 : 
o WAMP (Windows) 
o LAMP (Linux) 
o XAMP (Multi-platform) 
o MAMP (Macintosh) 
。 操作 系统 : 跨 平 台 
。 浏览 器 支持 : IE (Internet Explorer 8+), Firefox, Google chrome, Safari, Opera 


。 PHP 兼 容 性 : PHP 5.2+ 


下 载 WordPress 


当 打 开 和 链接 https://wordpress.org/download/, 将 能 看 到 一 个 屏幕 ， 如 下 : 


(A WORDPRESS.ORG a 


Showcase Themes Plugins Mobile Support Getinvolved About Blog Hosting Download WordPress 





Download WordPress 


Stablp Oownioad 1 ateot stable release WW Pr Versi | avallable 1 mat Downiomd WordPress 4.3 
from the links to your right. J you have no idea what to do with thi vnload, 
weTs mend sigrin th or r web hosting partners that offers a Download targt— 6 7 uD 
Beln Relesss a by 
} 


| p' f 
ft iPr tin r Ff 
Release Notification 
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inter nh our' ) of for the fest tin nple 1 | | 
wh ted 1 jh the lation F 3 | uf f 1 | 
J llat | 1,1 nd 寺 WW tL vy trout ! 
| ums are 0S res0urte, wt easoned A ee i 
Yiibai. com 吝 
Experts volonteer tbe time to heip you qe! 1he most oul of yocr bi yi 1 ,下 
请 从 官 


方 网 站 WordPress 的 zip 文 件 。 


创建 存储 数据 库 










a a Re me "4 
TutorialsPoint 后 着 和 


人 
从/ 


。 WordPress 需 要 MySQL 数 据 库 。 因 此 ， 创 建 用 户 名 /密码 〈 例 如 用 户 以 roof， 密码 
为 “123456"”， 也 可 以 设置 其 它 ) ， 并 创建 一 个 新 的 空 数据 库 。 


。 接 下 来 ， 您 可 以 继续 安装 过 程 如 下 文 所 述 。 
hy 士 
安装 向 导 


这 很 容易 安装 WordPress 在 你 的 系统 上 。 以 下 步骤 描述 了 如 何 设置 WordPress 在 本 地 系统 


O 


FF 


步骤 (1): 解压 下 载 的 WordPress 的 文件 夹 ， 并 把 它 上 传 到 Web 服 务 器 或 本 地 主机 ， 本 示例 中 
使 用 Wampserver。 


步骤 (2): 打开 浏览 器 ， 然 后 导航 到 WordPress 文件 路 径 ， 那 么 会 得 到 WordPress 的 安装 程序 
en i 在 我 们 的 示例 中 ， 安装 的 路 径 是 ， : D:wamp\www 目录 ， 如 
下 : 


而 








| 文 H 虽 “ 编 误 人 编辑 (E) ”查看 (MW 工具 中 it 
组 织 ~ 包含 到 库 中 共享 ~ 刻录 ”新 建文 件 夫 





次 收藏 夫 全 名称 修改 日 期 
烛 wp-admin 2015/10/20 10:49 
本 | 点 面 出 wp-content 2015/10/20 10:49 
请 库 而 wp-includes 2015/10/20 10:49 顽 
县 Administrator | index.php 2015, PHP 文件 
条 计算 机 license.bct 2 TXT 文件 
ee 加 readme.html 2015/9/15 14:26 Chrome HTML D... 
本 地 磁盘 (C:) 
= 四 | wp-activate.php 2015/9/ PHP 文件 
S A (0) [a] wp-blog-header.php 2015/9/ PHP 文件 
由 360Downloads § wp-comments-post.ph 2015/9/ PHP 文件 
ls] wp post.php 
则 Program Files 





此 | wp-config-sample.php 2015/9/ PHP 文件 


BD program Files (x86) 车] wp-cron.php 2015/9/ PHP 文件 
DD software | wp-links-opml.php 2015/9/ PHP 文件 
更 wamp $s) wp-load.php 2015/9/ PHP 文件 

BD alias [8s] wp-login.php 2015/9/ PHP 文件 
| wp-mail.php 2015/9/ PHP 文件 
加 bin 8| wp-settings.php 2015/9/ PHP 文件 
国 lang | wp-signup.php 2015/9/ PHP 文件 


BD apps 


| wp-trackback.php 2015/9/ PHP 文件 
8 xmlrpc.php 2015/9/3 3:33 PHP 文件 


BD logs 


BD scripts 


用 19 个 对 入 


19 个 项 目 i 








启动 NAMP， 然 后 在 浏览 器 中 输入 网 址 : http://127.0.0.1 ， 如 下 所 示 : 





sb 
~ 
© 


Word ap 
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Romana 
Pycckui 
Sloventina 
Slovenscina 
Shqip 
Cpnckn je3uk 
Svenska 
ua 
Tagalog 
Turkce 
Uyqlurqa 
yxpaiHcbKa 

















为 WordPress 选择 语言 ， 然 后 点 击 继续 。 


步骤 (3): 在 此 步骤 中 ， 可 以 继续 使 用 WordPress 安装 前 查看 所 需 的 数据 库 中 的 信息 。 
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Welcome to WordPress. Before getting started, we need some information on the database, YOU will 
need to know the following items before proceeding. 


1. Database name 

2. Database username 

3, Database password 

4, Database host 

5. Table prefix (if you want to run more than one WordPress in a single database) 


WeTre going to use this information to create a wp-config.php file, If for any reason this automatic file 
creation doesnt Work, dont worry. All this does is fill in the database information to a configuration 
file. You may also simply open wp-config-sample .php in a text editor, fill in your information, and 
save it as wp-config.php. Need more help? We got it 


In all likelihood, these items were supplied to you by your Web Host lf you do not have this information, 
then YOU will need to contact them before you can continue, If you're all ready... 


点 击 Let's gol 


yiibai. com 


步骤 (4): 在 这 里 ， 有 如 下 的 画面 描述 用 来 输入 关于 MYSQL 数 据 库 的 信息 。 在 操作 这 一 步 之 前 
我 们 先 创 建 一 个 数据 库 : yiibai_db。 
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Below you should enter your database connection details. Ifyou're not sure about these, contact your host. 


Database Name yiibai_db The name ofthe database you wantto run 
WP in. 

User Name root Your MySQL username 

Password -and your MySQL password. 

Database Host localhost You should be able to get this info from 


your web host if localhost does not work. 


Table Prefix wp fyou wantto run multiple WordPress 
installations in a single database, change 
this. 

Submit 


。 数据 库 名 称 : 输入 您 的 WordPress 要 连接 的 MySQL 数 据 库 已 经 创建 的 数据 库 名 (这 里 
是 : yiibai db) 。 


。 用 户 名 : 输入 您 的 MySQL 数 据 库 的 用 户 名 。 
。 密码 : 输入 您 的 MySQL 数 据 库 的 密码 。 
。 数据 库 主 机 : 填写 主机 名 ， 默 认 情 况 下 它 会 被 本 地 主机 (localhost) 。 


。 表 前 级 : 它 被 用 来 添加 数据 库 中 表 的 前 级 ， 这 有 助 于 运行 多 个 网 站 共享 同一 数据 库 。 
用 默认 值 。 


[ 


填充 的 所 有 信息 后 ， 点 击 Submit 按钮 。 


步骤 (5): 在 这 里 ，WordPress 的 检查 数据 库 的 设置 ， 让 您 的 确认 屏幕 ， 如 下 图 所 示 。 


All right, sparky! Youve made it through this part of the installation. WordPress can now communicate 
With your database, if you are ready time now to.. 


~ 


点 周 Run the install 


Step (6): 在 这 里 ， 必 须 输 入 有 关 管 理 的 信息 。 


| Please provide a valid username. 


Site Title Yiibai Tutorial 


Username admin 


Usernames can have only alphanumeric characters, spaces, underscores, hyphens, periods, 


and the @ symbol. 





Password 123456 oP Hide 


Important: You will need this password to log in. Please store it in a secure location. 
Confirm Password 4 Confirm use of weak password 


Your E-mail yiibai.com@gmail.com 


Double-check your email address before continuing. 


Privacy W Allow search engines to index this site 


Install Wordpress 


它 包含 以 下 字段 : 
。 Site Title: 要 创建 的 WordPress( 网 络 ) 的 名 字 。 
。 Username: 输入 用 户 名 ， 当 您 在 登陆 WordPress 时 使 用 。 
。 Confirm Password : 确认 使 用 弱 密 码 
。 Your E-mail: 请 输入 您 的 电子 邮件 地 址 ， 这 有 助 于 恢复 密码 或 任何 更 新 。 
。 Privacy: 它 人 允许 搜索 引擎 索引 检查 复 选 框 后 ， 这 个 网 站 。 

填补 所 有 的 信息 后 ， 点 击 安装 WordPress 按 钮 。 


步骤 (7): 安装 成 功 后 ， 会 得 到 WordPress 成 功 的 画面 ， 如 下 图 所 示 。 
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SUCCesSS! 
WordPress has been installed. Were you expecting more steps? Sorry to disappoint. 


Username admin 


Password Your chosen password 


在 这 里 你 可 以 查看 WordPress 增加 的 用 户 名 和 密码 细节 。 
点 击 Log In 按钮 . 


Step (8): 点 击 登 录 后 ， 会 得 到 一 个 WordPress 的 管理 面板 ， 如 下 图 所 示 。 





Username 


Password 








Remember Me 


Lost your password? 


< Back to Yiibai Tutorial 


在 这 里 ， 输 入 您 在 安装 过 程 中 第 6 步 提 到 的 用 户 名 和 密码 ， 点 击 登 录 按钮 ， 如 图 所 示 。 


Wordpress 安 装 - Wordpress 教 程 175 


Wordpress 仪 表 板 - Wordpress 教 程 


WordPress 的 仪表 盘 是 当 登 录 到 你 的 博客 后 的 管理 区 域 ， 这 将 显示 该 网 站 的 介绍 ， 这 是 登陆 成 
功 后 的 第 一 个 画面 。 这 些小 工具 提供 信息 ， 并 给 出 了 所 发 生 的 事情 并 显示 博客 在 一 个 一 目 了 

然 概 述 的 集合 。 可 以 通过 使 用 一 些 快 速 链接 !， 如 快速 写 入 草案 自 定义 您 的 需求 ， 回 复 最 新 评 
论 等 。 


仪表 盘 可 分 类 如 下 所 示 。 每 个 类 别 将 在 以 下 部 分 中 讨论 : 


会 YiibaiTutorial 已 1 胃 十 New Howdy admin 山 
Dismiss 
BR Dashboard Welcome to WordPress! 
Weve assembled some links to get you started: 
Home i 
Updates . 
i Get Started Next Steps More Actions 
区 write your first blog post Manage widgets or menus 
Posts Customize Your Site 
。 十 Add an About page 多 Turn comments on or off 
Media 
or change your theme completely 回 View your site 谷 Learn more about getting 
Pages started 
Comments 
外 Appearance At a Glance Quick Draft 
和 Plugins 筷 起 1 Post 加 1 Page Title 
& Users 盟 1 Comment 
Ur ] 
fF Tools WordPress 4.3.1 running Twenty Fifteen theme. 
Settings 
@@ co Activity 
Recently Published 
Today, 3:31 am Hello world! 
WordPress News 
Comments 





仪表 盘 菜 单 


WordPress 的 控制 板 提 供 了 包含 某 些 菜单 选项 ， 如 发 表 帖 子 ， 媒 体 库 ， 页 面 ， 评 论 ， 外 观 选 
项 ， 插 件 ， 用 户 ， 工 具 和 设置 在 左 侧 导 航 菜单 。 


Screen Options - 屏幕 选项 


仪表 板 包含 不 同类 型 的 小 部 件 可 以 显示 或 隐藏 屏幕 。 它 包含 复 选 框 ， 以 显示 或 隐藏 屏幕 选 
项 ， 也 可 以 让 管理 员 屏 幕 上 的 定制 部 分 选项 。 


Welcome - 欢迎 部 分 


它 包括 自 定义 网 站 的 按钮 ， 人 允许 自 定义 WordPress 主题 。 中 央 列 提供 了 一 些 如 创建 一 个 博客 
文章 ， 创 建 一 个 页 面 ， 查 看 网 站 前 端的 有 用 的 链接 。 最 后 一 列 包 含 链接 到 相关 的 评论 窗口 小 
部 件 ， 菜 单 设 置 ， 以 及 在 WordPress 的 手 抄 本 链接 到 WordPress 的 页 面 等 。 


Quick Draft -快速 草稿 


快速 草稿 是 一 个 小 型 的 帖子 编辑 器 允许 书写 ， 保 存 和 发 布 后 的 管理 仪表 板 。 它 包括 对 草案 的 
标题 ， 草 案 的 一 些 注意 事项 ， 并 将 其 保存 为 草稿 。 


WordPress News - WordPress 新 闻 


WordPress 新 闻 插 件 显示 最 新 消息 ， 如 最 新 的 软件 版 本 ， 更 新 ， 警 报 ， 新 闻 就 来 自 WordPress 
官方 博客 软件 等 。 


Activity - 活动 


活动 部 件 包括 博客 的 最 新 评论 ， 最 近 的 帖子 ， 最 近 发 布 的 文章 。 它 可 以 让 取消 审核 或 批准 的 
评论 ， 回 复评 论 ， 编 辑 注 释 也 可 以 删除 评论 或 将 其 移动 到 垃圾 邮件 。 


At a Glance -概览 


本 节 提 供 了 概述 博客 帖子 ， 发 表 文 章 和 页 面 ， 评 论 的 数量 。 当 点 击 这 些 链接 ， 将 使 用 相应 的 
屏幕 。 它 显示 目前 在 网 站 上 运行 的 主题 运行 WordPress 的 最 新 版 本 。 


mw ，，、 
Wordpress 弟 规 设置 - Wordpress 教 程 

在 本 章 中 ， 我 们 将 研究 有 关 WordPress 的 常规 设置 。WordPress 的 常规 设置 用 于 网 站 设置 基本 
配置 。 在 设置 管理 屏幕 ， 这 是 一 个 默认 的 设 定 画面 。 

要 访问 常规 设置 ， 只 要 按照 下 面 的 步骤 : 


Step (1): 点 击 设置 -> 常规 在 WordPress 的 选项 。 
Step (2)*: 接着 ， 将 显示 常规 设置 * 页 面 如 下 所 示 。 
以 下 是 设置 字段 的 细节 。 


。 站 点 标题 : 它 显示 在 网 站 中 的 模板 头 的 名 称 。 
。 副标题 *:* 显示 你 的 网 站 很 短 的 句子 。 


WordPress 地 址 *(URL):** 这 是 WordPress 的 目录 的 URL， 所 有 核心 应 用 程序 文件 都 存 
在 这 里 。 


网 站 地 址 (URL): 输 入 希望 您 的 网 站 显示 在 浏览 器 的 网 址 。 
Email 地 址 :输入 您 的 电子 邮件 地 址 ， 这 有 助 于 恢复 您 的 密码 或 任何 更 新 。 


。 成 员 资 格 党 :六 任何 人 都 可 以 在 自己 的 网 站 后 ， 选 中 此 复 选 框 注册 一 个 帐号 。 
。 用 户 黑 认 角 色 关 :** 默 认 角 色 被 设 定 为 新 注册 的 用 户 或 成 员 。 

。 时 区 *:* 设 置 基于 特定 城市 的 时 区 。 

。 日 期 格式 *:* 设 置 日 期 格式 ， 需 要 显示 的 网 站 上 。 

。 时 间 格 式 *:* 设 置 时 间 格 式 ， 因 为 需要 显示 在 网 站 上 。 


e 一 星期 开始 于 **:* 选 择 您 喜欢 的 位 置 开 始 WordPress 的 日 历 星期 的 一 天 。 默 认 情 况 下 设 
置 为 周一 。 


e。 站 点 语言 *:* 设 置 WordPress 后 台 显 示 的 语言 。 


Step(3): 填 充 所 有 关于 常规 设置 的 信息 后 ， 点 击 保存 更 改 按钮 。 其 保存 您 的 所 有 常规 设置 信 
息 Le] 
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撰写 设置 控制 WordPress 的 写作 经 验 和 提供 选项 来 定制 WordPress 站 点 。 这 些 设 置 控制 
WordPress 的 功能 在 添加 和 编辑 帖子 /发 布 ， 网 页 和 文章 类 型 ， 以 及 通过 电子 邮件 的 可 选 功 
能 ， 如 远程 发 布 ， 发 布 和 更 新 服务 。 


要 访问 撰写 设置 ， 只 要 按照 下 面 的 步骤 : 


Step 1: 要 转 到 撰写 设置 ， 选 择 设置 -> 撰写 选项 . 






个 Yiibai Tutorial 性 1 明 十 新 建 


仪表 盘 








欢迎 使 用 WordPress ! 

我 们 准备 了 几 个 链接 供 您 开始 : 

开始 使 用 接 下 来 

区 氛 写 您 的 第 一 篇 博 3 
十 添加 “关于 "页 面 

回 查看 站 点 





或 更 换 主 题 







轩 1 个 页 面 


固定 链接 用 Twenty Fifteen 主 题 。 


Step 2: 接 下 来 ， 将 显示 撰写 设置 页 面 ， 如 下 图 所 示 。 


图 省 vibaiTutorial 合 1 站 十 新 建 


5 
a 撰写 设置 
准 文章 、 
默认 文章 分 类 目录 Uncategorized v 
后 ] 多 媒体 
里 页面 默认 文章 形式 标准 ， 
盟 评论 
二 通过 电子 邮件 发 布 
访 ” 外 次 
Se 要 通过 电子 邮件 发 表 文章 ， 您 必须 设置 一 个 有 POP3 访 问 权限 的 私密 电子 邮件 账户 。 任 何 投递 到 这 个 电子 邮件 地 址 的 信件 将 会 被 发 表 ， 所 以 您 必 
央 插件 机 字符 串 : 旋 024ZIp 、yEVrfxfr 、xRBpb681 。 
吉 用 户 
| 邮件 服务 器 mail.example.com 端口 110 
设置 
登录 名 login@example.com 
密码 password 
默认 邮件 发 表 分 类 目录 Uncategorized v 
更 新 服务 











在 您 发 表 新 文章 时 ，WordpPress 会 自动 通知 站 点 更 新 服务 。 要 获取 更 多 资讯 ， 请 参见 Codex 上 的 更 新 服务 。 用 换行 分 隅 多 个 服务 URL。 














Tt 


以 下 是 有 关 撰 写 设 置 字段 的 细节 。 


。 默认 文章 分 类 目录 * : * 它 是 被 应 用 到 后 一 个 类 别 ， 可 以 把 它 作为 未 分 类 。 
。 默认 文章 形式 : 它 由 主题 选择 文章 格式 应 用 于 后 或 创造 不 同 风格 不 同类 型 的 文章 。 


。 通过 电子 邮件 发 布 人 #: 关 此 选项 使 用 电子 邮件 地 址 为 您 创造 文章 ， 以 及 文章 发 布 在 您 的 博客 
的 电子 邮件 。 要 使 用 此 功能 ， 需 要 建立 一 个 秘密 的 电子 邮件 帐户 并 使 用 POP3 访 问 ， 并 在 
此 地 址 上 接收 任何 邮件 发 布 的 文章 。 


e。 邮件 服务 器 : 它 人 允许 读 取 发 送 到 Wordpress 并 存储 检索 电子 邮件 。 为 此 ， 您 需要 有 兼容 
POP3 邮 件 服务 器 ， 这 将 有 URI 地 址 ， 例 如 : mail.example.com， 应 该 在 这 里 输入 。 


。 登录 名 : 要 创建 文章 ，WordPress 需 要 自己 的 电子 邮件 帐户 。 登 录 名 将 使 用 这 个 电子 邮件 
地 址 ， 并 应 当 保密 的 垃圾 邮件 发 送 者 将 帖子 链接 重 定向 到 自己 的 网 站 。 


。 密码 : 为 上 述 电子 邮件 地 址 设置 密码 。 


。 默认 邮件 分 类 : 它 人 允许 所 有 通过 电子 邮件 功能 ， 通 过 电子 邮件 发 布 帖 子 选择 自 定义 类 
别 。 


e。 更 新 服务 **:** 当 发 布 一 个 新 的 文章 ，WordPress 会 自动 在 框 中 通知 网 站 更 新 服务 。 请 参阅 
更 新 服务 关于 手 抄 本 可 能 的 服务 在 一 个 长 长 的 清单 中 。 


Step(3): 填 补 上 述 所 有 资料 下 一 步 点 击 保存 更 改 按钮 后 ， 保 存 您 的 信息 。 
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在 本 章 中 ， 我 们 将 研究 有 关 在 WordPress 的 阅读 设置 。 阅 读 设置 用 于 设置 相关 前 端 页 面 的 内 
容 。 在 这 里 你 可 以 设置 在 主页 上 显示 文章 的 数量 。 


要 访问 的 阅读 设置 ， 只 需 遵 遵循 以 下 步骤 : 


Step (1): 点 击 设置 -> 阅读 选项 在 WordPress 中 . 





十 新 建 


仪表 盘 






人 ITILeERRE 








欢迎 使 用 WordPress! 
我 们 准备 了 几 个 链接 殿 您 开始 : 





开始 使 用 接 下 来 

四” 撰写 您 的 第 一 篇 
十 添加 关于 "页面 
回 查看 站 点 





或 更 换 主 题 






固定 链接 
用 Twenty Fifteen 主 题 。 


Pe 


Step(2): 接 着 ， 将 显示 阅读 设置 页 面 如 下 。 


午 十 新 建 


阅读 设置 

首页 显示 s) 您 的 最 新 文章 
一 个 静态 页 面 《在 下 方 选 择 》 
主页 : v 
文章 页 : 

博客 页 面 至 多 显示 10 篇 文章 

Feed 中 显示 最 近 10 个 项 目 


对 于 feed 中 的 每 篇 文章 ， 显 示 e) 全 文 





以 下 是 阅读 设置 的 字段 细节 。 


。 首页 显示 *:* 这 部 分 是 用 来 显示 在 以 下 任何 格式 的 头 版 : 


o 一 个 静态 页 面 (下面 选 择 ) : 它 显示 在 头 版 上 的 静态 页 面 。 
a 主页 : 可 以 从 下 拉 显 示 选 择 想 要 在 头 版 的 实际 页 面 。 

s 文章 面 : 可 以 选择 其 中 包含 文章 的 下 拉 页 面 。 

。 博客 页 面 最 多 显示 : 每 个 页 面 或 网 站 上 显示 文章 的 数量 。 缺 省 情况 下 ， 它 设置 为 10。 


。 Feed 中 显示 最 近 0 订阅 的 用 户 可 以 查看 文章 的 数目 。 缺 省 情 
况 下 ， 它 被 设置 为 


对 于 feed 中 的 每 篇 文章 ， 显 示 : 此 部 分 用 于 选择 以 下 任何 一 种 格式 来 显示 日 志 : 


o 全 文 : 它 显 示 了 完整 的 文章 。 这 是 默认 的 设置 。 
o 摘要 : 它 显 示 的 文章 的 摘要 。 


搜索 引擎 可 见 性 : 点 击 复 选 框 后 ， 不 鼓励 搜索 引擎 素 引 ， 从 这 个 网 站 ， 你 的 网 站 会 被 搜 
索引 擎 忽略 。 


Step(3): 填 充 所 有 的 信息 后 ， 接 下 来 点 击 保存 更 改 按钮 保存 您 的 阅读 设置 等 信息 。 


Wordpress 讨 论 设置 - Wordpress 教 程 


在 本 章 中 ， 我 们 将 研究 有 关 在 WordPress 的 讨论 设置 。WordPress 讨 论 设置 可 以 定义 博 主 和 与 访 
问 者 之 间 的 互动 。 这 些 设置 由 管理 员 做 是 为 了 控制 通过 文章 /网 页 访问 的 用 户 。 
要 访问 讨论 的 设置 ， 只 需 按照 以 下 步骤 操作 : 


Step 1: 点 击 设置 -> 讨论 选项 在 WordPress。 


Step 2: 接着 ， 将 显示 讨论 设置 页 面 如 下 所 示 。 





























WE 易 百 教程 明 0 十 新建 您 好 ，admin | 
帮助 
讨论 设置 
默认 文章 设置 Y| 尝试 通知 文章 中 链接 的 博客 
Y| 人 允许 其 他 博 寄 发 送 链接 通知 《pingback 和 trackbacky》 到 新 文章 
Y| 人 允许 他 人 在 新 文章 上 发 表 评论 
(这 些 设 置 可 被 具体 的 文章 设置 所 覆盖 。) 
其 他 评论 设置 Vv| 评论 者 必须 填写 姓名 和 电子 邮件 
用 户 必 须 注 册 并 登录 才 可 以 发 表 评论 
自动 关闭 发 布 14 天 后 的 文章 上 的 评论 功能 
Y| 启用 评论 嵌 套 ， 最 多 炭 套 5 " 层 
分 页 显示 评论 ， 每 页 显示 50 条 评论 ， 默 认 显示 最 后 ， 一 页 
在 每 个 页 面 顶部 显示 旧 的 评论 
何 时 发 送 电子 邮件 Y| 有 人 发 表 评论 时 





以 下 是 讨论 设置 的 字段 。 
。 默认 文章 设置 *:** 这 些 设置 是 默认 创建 新 页 面 或 新 文章 。 这 包含 三 个 设置 。 它们 是 : 


o 尝试 通知 文章 中 链接 的 博客 : 当 您 发 布 的 文章 则 给 出 通知 (发 送 ping 和 引用 通告 ) 到 
其 他 博客 。 


o 允许 其 他 博客 发 送 链接 通知 (pingback 和 trackback) 到 新 文章 : 接受 来 自 其 他 博客 的 
ping。 


o 允许 他 人 在 新 文章 上 发 表 评 论 : 可 以 允许 或 禁止 他 人 使 用 该 设 定 你 的 文章 发 表 评 论 。 
您 可 以 更 改 设置 ， 根 据 您 的 意愿 为 个 人 文章 。 
e 其 他 评论 设置 *:** 此 设置 有 以 下 选项 


。 评论 者 必须 填写 姓名 和 电子 邮件 : 当 您 选中 该 复 选 框 ， 其 强制 性 的 访问 时 填补 他 们 的 
姓名 和 电子 邮件 地 址 。 


用 户 必 须 注册 并 登录 才 可 以 发 表 评 论 : 如 果 您 选中 该 复 选 框 ， 只 有 已 注册 那些 人 才 可 
以 发 表 评 论 ， 如 果 没 有 选中 ， 任 何人 都 可 以 发 布 任何 数量 的 评论 。 


o 自动 关闭 发 布 x 天 后 的 文章 上 的 评论 功能 : 此 选项 根据 您 的 意愿 可 以 接受 评论 仅 适 用 
于 一 个 特定 的 时 间 段 。 


o 启用 评论 馈 套 ， 最 多 骨 套 x 层 : 当 您 选中 此 选项 ， 游 客 可 以 回复 或 有 一 个 讨论 ， 并 得 
到 响应 。 


o 分 页 显示 评论 ， 每 页 显示 条 评论 ， 默 认 显 示 最 后 最 前 一 页 : 如 果 您 的 网 页 有 很 多 评 
论 ， 那 么 可 以 选中 此 复 选 框 将 它们 分 为 不 同 的 页 面 


o 在 每 个 页 面 顶部 显示 旧 的 新 的 评论 : 可 以 安排 升序 或 降序 排列 形式 的 评论 。 
何 时 发 送 电 子 邮 件 * : * 此 设置 包含 两 个 选项 ， 分 别 是 : 


o 有 人 发 表 评 论 时 : 当 您 选中 此 框 中 ， 作 者 在 别人 发 布 每 一 个 评论 时 会 收 到 电子 邮 
件 。 


o 有 评论 等 待 审核 时 : 这 是 用 来 如 果 不 希望 你 的 评论 进行 更 新 之 前 ， 它 用 于 放 缓 管 
理 。 


在 评论 显示 之 前 : 此 设置 允许 如 何 您 的 文章 被 控制 。 有 两 个 设置 如 下 : 


o 评论 必须 经 人 工 审核 : 如 果 您 选中 此 复 选 框 ， 然 后 只 能 由 管理 员 批 准 的 评论 可 以 在 
文章 或 页 面 显示 。 


o 评论 者 先前 须 有 评论 通过 了 审核 : 选中 时 确定 批准 作者 ， 便 这 样 评论 先前 发 布 的 评论 
的 电子 邮件 地 址 相 匹 配 的 注释 进行 检查 ， 否 则 评论 等 待 审核 。 


评论 审核 : 包含 被 允许 进入 一 个 注释 ， 链 接 只 是 一 个 具体 的 数字 。 


评论 黑 名单 : 可 以 输入 自己 的 垃圾 邮件 个 词语 ， 不 希望 访问 者 进入 评论 ， 网 址 ， 电 子 邮 
件 等 之 后 它 会 过 滤 评 论 。 


头像 :头像 是 一 个 小 图 像 ， 在 你 的 名 字 旁 边 的 仪表 龟 屏 幕 的 顶部 右上 角 显 示 。 这 就 像 你 的 
个 人 资料 图 片 。 在 这 里 有 更 多 的 选项 ， 可 以 设置 你 的 WordPress 网 站 的 头像 。 


o 头像 显示 : 除了 名 字 外 它 显 示 你 的 头像 


o 最 高 等 级 : 在 这 里 有 替身 ， 可 以 使 用 的 其 他 四 个 选项 。 它 们 是 G，PG，R 和 X。 这 是 
根据 你 想 显示 文章 哪 种 类 型 选择 读者 的 年 龄 段 。 

o 默认 头像 : 在 这 个 选项 中 有 几 个 类 型 的 替身 与 图 像 ; 可 以 根据 您 的 访问 者 的 电子 邮件 
地 址 使 用 这 些 替 身 。 


Step 3: 接 下 来 ， 您 可 以 点 击 保存 改变 按钮 保存 更 改 。 


Wordpress 煤 体 设 置 - Wordpress 教 程 


在 本 章 中 ， 我 们 将 研究 有 关 在 WordPress 的 媒体 设置 。 它 是 用 来 设置 高 度 和 宽度 ， 使 用 到 你 的 


网 站 上 的 图 像 。 
第 1 步 : 点 击 设置 - > 媒体 选择 在 WordPress 中 。 


第 2 步 : 接 下 来 ， 你 会 得 到 媒体 的 设置 页 面 ， 如 下 图 所 示 。 


以 下 是 媒体 设置 的 字段 的 详细 信息 

。 缩 略 图 大 小 : 在 这 里 ， 您 可 以 设置 缩 略图 的 宽度 和 高 度 尺 寸 。 

。 中 等 大 小 : 在 这 里 可 以 设置 中 等 大 小 的 图 片 的 宽度 和 高 度 。 

。 大 尺寸 : 设置 较 大 的 图 像 的 宽度 和 高 度 。 

。 上 传 文件 : 勾 选 复 选 框 后 ， 上 传 的 图 片 会 基于 文件 夹 排 成 年 份 和 月 份 的 形式 。 
第 3 步 : 设置 在 像素 尺寸 后 ， 点 击 保存 更 改 按钮 。 它 就 可 以 保存 你 的 媒体 设置 信息 


Wordpress 固 定 链接 设置 - Wordpress 教 程 


在 本 章 中 ， 我 们 将 学 习 如 何在 WordPress 中 设置 es 固定 链接 是 一 个 特定 的 博客 文章 或 
类 别 使 用 的 永久 链接 。 它 允 许 设置 默认 固定 链接 结构 。 这 些 设置 用 于 固定 链接 添加 到 您 的 
WordPress 文 章 。 下 面 是 访问 固定 链接 设置 的 步 又。 


第 1 步 : 在 左 侧 导航 菜单 选项 点 击 设置 -> 固定 链接 。 
第 2 步 : 当 点 击 固定 链接 页 面 出 现在 屏幕 上 如 下 面 所 示 。 


这 里 有 一 些 设置 ， 你 可 以 在 WordPress 填 写 设置 。 
。 常用 的 设置 
在 这 里 ， 可 以 检查 单 选 按钮 ， 选 择 您 的 博客 固定 链接 结构 。 
o 默认 : 在 WordPress 中 它 设置 默认 的 URL 结 构 。 
o 日 期 和 名 称 型 : 它 根 据 您 的 文章 的 日 期 和 名 称 设置 URL 结 构 。 
o 月 份 和 * 名 称 型 :* 这 里 月 份 的 名 字 是 URL 结 构 在 您 的 文章 中 。 
。 数字 型 : URL 结 构 设置 数字 在 您 的 文章 中 。 
o 文章 名 : 它 设置 文章 名 称 在 URL 结 构 在 您 的 文章 中 。 


o 自 定义 结构 : 在 这 里 ， 您 可 以 通过 编写 所 需 的 名 称 在 给 定 的 文本 框 中 设置 您 所 选择 的 
URL 结 构 。 


o 分 类 文章 : 添加 自 定义 分 类 网 址 前 级 。 
o 标签 文章 : 添加 自 定义 前 到 您 的 标签 网 址 。 


第 3 步 : 当 用 修改 完成 后 ， 点 击 保存 更 改 按钮 保存 设置 固定 链接 。 


Wordpress 插 件 设 置 - Wordpress 教 程 


在 本 章 中 ， 我 们 将 研究 在 你 的 WordPress 网 站 如 何 使 用 插件 。 插 件 可 以 很 容易 地 修改 ， 定 制 或 
增强 的 WordPress 博 客 或 帖子 。WordPress 插 件 是 可 以 上 传 以 扩展 网 站 的 功能 的 软件 。 它 们 增 
加 服务 或 功能 到 WordPress 博 客 。 插件 可 让 您 的 工作 更 轻松 。 下 面 是 简单 添加 插件 的 步 又 。 


第 1 步 : 点 击 左 侧 侧 边栏 点 击 插件 -> 安装 插件 ， 如 下 图 所 示 。 





洛 易 百 教程 ” 明 


显示 选项 











仪表 盘 


欢迎 使 用 WordPress! i 
我 们 准备 了 几 个 链接 供 您 开始 : 


开始 使 用 接 下 来 更 多 操作 
革 控 瑟 您 的 第 一 篇 博文 图 管理 边栏 小 工具 和 菜单 
十 添加 关于 ' 人 页 面 胃 打开 /关闭 评论 功能 
回 查看 站 点 序 了 解 更 多 新 手 上 路 知识 
已 安装 的 插件 
安装 插件 快速 草稿 
编辑 
ER 标题 


盟 1 条 评论 


WordPress 4.3.1， 使 用 Twenty Fifteen 主 题 。 


第 2 步 : 接 下 来 ， 会 出 现下 面 的 页 面 


在 这 里 ， 在 这 个 部 分 中 ， 您 可 以 查看 已 经 安装 的 插件 。 
第 3 步 : 点 击 插件 -> 安装 插件 ， 如 下 图 所 示 


您 好 ，admin 网 
帮助 


添加 插 KE 7) 


特色 ”热门 ”推荐 收藏 


中 的 插件 ， 或 者 在 这 个 页 面 上 传 .zip 格 式 的 插 









插件 为 WordPress 添 加 新 功能 。 您 可 以 在 您 的 控制 板 选 择 并 直接 安装 WordPress 提 
件 包 。 
Pa WP Super Cache PP Akismet 
已 安装 的 插件 A fast caching engin 
WordPress that produces 
支 装 插件 static html files 
编辑 
扩 Automattic2y 和 党 
护 Automattic 训 党 
依依 依依 77 (681) 最 近 更 新 : 2 周 前 
100 万 :活跃 安装 v 该 插件 兼容 于 您 当前 使 三 太太 三 信 (444) 最 近 更 新 : 1 周 前 
用 的 WordPress 版 本 。 100 万 + 活跃 安装 V 该 插件 兼容 于 您 当前 使 
用 的 WordPress 版 本 。 





第 4 步 : 接 下 来 ，WordPress 所 使 用 的 插件 列表 就 会 出 现 如 图 。 在 这 里 ， 您 可 以 直接 从 可 用 列 
表 中 安装 插件 ， 也 可 以 点 击 上 传 插件 。 


。 当 你 点 击 上 传 插件 ， 会 得 到 如 下 页 面 。 






| 选择 文件 | 未 选择 任 作 文件 


已 安装 的 质 件 
安装 插件 
编辑 


a 用 户 
包工 具 





| 览 需要 回 到 页 面 ， 可 以 从 WordPress 网 站 选择 插件 。 如 果 点 击 选择 文件 ， 可 以 从 你 


点 击 闹 多 ,FT 


的 系统 中 添加 文件 。 
。 否则 ， 在 这 里 我 们 可 以 直接 选择 所 需要 的 插件 ， 然 后 点 击 立即 安装 ， 如 下 图 所 示 。 


十 新 建 您 好 ，admin 
帮助 


添加 插件 ”上 传 插件 


特色 ”热门 推荐 收藏 


插件 为 WordPress 添 加 新 功能 。 您 可 以 在 您 的 控制 板 选 择 并 直接 安装 WordPress 中 的 插件 ， 或 者 在 这 个 页 面 上 传 .zip 格 式 的 插件 包 。 





Pa WP Super Cache Pa Akismet 
更 多 详情 


Akismet checks your comments 






已 安装 的 插件 against the Akismet Web 
安装 插件 see if they look like spam or not 
编辑 Automattic ey 全 
才 用 户 是 0 
会 傅 傅 傅 77 (681) 最 近 更 新 : 2 周 前 俩 俩 俩 人 广 食 (444) 最 近 更 新 : 1 周 前 
je 工具 100 万 + 活跃 安装 V 该 插件 兼容 于 您 当前 使 用 的 100 万 + 活跃 安装 V 该 插件 兼容 于 您 当前 使 用 的 
WordPress 版 本 。 Wordpress 版 本 。 


图 设置 


当 你 点 击 立 即 安装 ， 包 开始 变 成 下 载 并 安装 。 后 来 ， 点 击 启用 插件 ， 以 活动 插件 在 
WordPress 中 使 用 ， 如 下 图 所 示 。 









正在 安装 插件 : WP Super Cache 1.4.6 


正在 从 https://downloads .wordpress.org/plugin/wp-super-cache.1.4.6.zip 下 载 安装 包 ... 










正在 解压 缩 安装 包 ... 
正在 安装 插件 .… 
Super Cache 1.4.6 成 功 。 





名 插件 


已 安装 的 插件 
安装 插件 
编辑 


点 击 启动 插件 后 ， 会 得 到 一 个 消息 插件 激活 ， 也 可 以 在 列表 中 找到 已 安装 的 插件 。 


十 新 建 
显示 选项 帮助 
插件 ” 支 装 插件 
| WP Super Cache 已 禁用 。 请 去 插件 管理 首页 开启 矮 存 功 能 。 
插件 已 启用 。 
评论 全 部 启用 | 未 启用 搜索 已 安装 插件 
四 现 批量 操作 ， | 应 用 Se 
插件 插件 图 像 描述 
[1 Akismet nillions, Akisme t way in the world to protect your blog from spam. It 






Jr site protected even While 》 p. To get started: 1) Click the “Activate" link to the left of this 


description, 2) Sign up for an Akismet plan to get an API key, and 3) Go to your Akismet configuration page, 


安装 插件 启用 | 编辑 明 除 


and save your API key 


3.1.5 版 本 | 由 Automattic 创 建 | 查看 详情 


WP Super Cache Vey fast caching plugin for WordPress 
设置 “信用 编辑 6 版 本 | 由 Automattic 创 建 | 查看 详情 


下 面 给 出 的 插件 激活 的 消息 ， 可 以 查看 一 些 选项 ， 上 比如 全 部 ， 启 用 ， 未 启用 。 








o 当 点 击 启 用 出 现 以 下 页 面 。 在 这 里 ， 您 可 以 查看 所 有 已 启用 的 插件 。 


NW 














十 新 建 您 好 ， admin 
显示 选项 帮助 
插件 ”去 装 二 和 
| WP Super Cache 已 禁用 。 请 去 插件 管理 首页 开启 狠 存 功能 。 
全 部 3 站 | 启 由 (1) | 未 启用 搜索 已 安装 插件 
明 评论 批量 操作 应 用 a 
插件 图 像 描述 
人 学 外 观 
WP Super Cache Very fast caching plugin for Wordpress 
多 括 休 设置 停 用 编辑 1.4.6 版 本 | 由 Autornattic 创 建 | 查看 详情 
WP Super Cache must be configured. Go to the admin page to enable and configure the plugin. 
插件 司 像 描述 
批量 操作 ” ”应 用 1 项 目 








o 当 我 们 点 击 停 用 ， 获 取 显 示 其 可 用 但 没有 被 激活 的 插件 。 可 以 通过 点 击 启动 激活 此 
插件 。 


便 易 百 教程 ” 盟 十 新 建 


插件 ”去 装 插件 


WP Super Cache 已 禁用 。 请 去 插件 管理 首页 开启 笑 存 功能 。 


全 部 启用 未 启用 
批量 操作 ” ， 应 用 
插件 图 像 描述 
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启用 ”编辑 量 除 
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our site pr 





ription, 2) Sign \ 

















[Ee d save your APl key 
安装 插件 3.1.5 版 本 | 由 Automattic 创 建 | 查看 详情 
编辑 
你 好 多 莉 这 不 是 普通 的 插件 ， 它 象征 着 一 代 人 希望 有 和 热情， 浓缩 成 Louis Armstrong 的 四 个 字 : 
坚 用 户 启用 “编辑 量 除 站 点 后 台 每 个 页 面 的 右上 和 角 都 可 以 看 到 一 句 来 自 久 俏 红 娘 闪 音乐 剧 的 英文 原版 台词 





1 1.6 版 本 | 由 Matt Mullenweg 创 建 | 查看 详情 


图 设置 插件 图 像 描述 





显示 选项 帮助 


搜索 已 安装 插件 


2 项 目 


o protect your blog from spam. It 
ed: 1) Click the "Activate" link to the left of this 


你 好 ， 多 莉 。 在 启用 后 , 在 


% 点 击 批量 操作 ， 选 择 选项 ， 然 后 点 击 应 用 按钮 ， 可 以 更 新 ， 删 除 ， 启 用 各 个 插件 。 


国 个 易 百 教程 | 





插件 ”去 美 插件 


| WP Super Cache 已 禁用 。 请 去 插件 管理 首页 开启 你 存 功能 。 


未 启用 


图 像 描述 








是 除 


已 安装 的 括 件 
安装 插件 





你 好 多 莉 
启用 "编辑 “ 啊 除 











1.6 版 本 | 由 Matt Mullenweg 创 建 | 查看 详情 





插件 图 像 描述 















显示 选项 


搜索 已 安装 插件 


2 项 目 





% 在 搜索 已 安装 的 插件 ， 可 以 只 输入 插件 名 称 在 文本 框 ， 然 后 点 击 搜索 已 安装 的 插件 
按钮 ， 当 点 击 搜索 安装 插件 按钮 ， 进 入 以 下 页 面 与 相应 的 插件 。 这 里 我 们 假设 搜 


索 : wp 相关 插件 。 


播 件 支 莱 插件 。。 搜索 wp 的 结果 
WP Super Cache 已 禁用 。 请 去 插件 管理 首页 开启 短 存 功能 。 
全 部 启用 未 启用 Wh 


批量 操作 ”应 用 


插件 图 像 描述 


| WP Super Cache Very fast caching plugin for WordPress 


设置 信用 编辑 1.4.6 版 本 | 由 Automattic 创 建 | 查看 详情 

















经 插件 


已 安装 的 插件 
安装 插件 


WP Super Cache must be configured. Goto the admin pageto enable and configure the plugin. 





插件 图 像 描述 











批量 操作 ” 应 用 





您 好 ， admin 


显示 选项 帮助 


搜索 已 安装 插件 


1 项 目 


1 项 目 


AN 


第 5 步 : 从 边栏 点 击 插件 -> 编辑 器 。 


插件 去 半 插件。 “搜索 wp' 的 结果 
WP Super Cache 已 禁用 。 请 去 插件 管理 首页 开启 摆 存 功能 。 
全 部 | 启用 未 启用 


批量 操作 "| 应 用 
插件 图 像 描 述 


已 安装 的 插件 


安装 插件 





插件 





[| 





像 描述 














批量 操作 ” ”应 


被 显示 在 下 面 的 页 面 。 








十 新 建 


编辑 插件 


<?php 


Plugin Name: WP Super Cache 

Plugin URI: http://wordpress.org/plugins/wp-super-cache/ 
Description: Very fast caching plugin for WordPress. 
Version: 1.4.6 





Author: Automattic 

Author URI: http://automattic.com/ 
License: GPL2+ 

Text Domain: wp-super-cache 


Copyright Automattic and many other contributors. 


This program is free software; you can redistribute it and/or modify 
it under the terms of the GNU General Public License as published by 
the Free Software Foundation; either version 2 of the License, or 
(at your option) any later version. 


This program is distributed in the hope that it will be useful, 
but WITHOUT ANY WARRANTY; without even the implied warranty of 





27.0.0.1/wp-admin/plugin-editor, php?file=w wp- ‘super- -cache%2Fwp- -cache. php&plugin= =wp: super-ca cache%2Fw vp- cache.php 


此 页 面 允 许 编辑 插件 。 在 这 里 ， 我 们 有 一 个 解释 几 个 选项 ， 如 下 : 


选择 插件 编辑 : 下 面 请 从 下 拉 列 表 中 选择 插件 并 进行 编辑 。 
。 文档 : 这 里 从 下 拉 列 表 中 选择 工具 来 编辑 插件 。 
。 插件 文件 : 在 这 里 ， 可 以 从 列表 中 选择 文件 并 编辑 。 
编辑 插件 文件 完成 后 ， 点 击 更 新 文件 


WP Super cache Very fast caching plugin for Wordpress 
设置 pr 1.4.6 版 本 | 由 Automattic 创 建 | 查看 详情 


WP Super Cache must be configured. Go to the admin page to enable and configure the plugin. 


编辑 wp-super-cache/wp-cache.php (已 启用 ) 选择 要 编辑 的 插件 : 


您 好 ，admin 





























1 项 











您 好 ， admin 


帮助 


WP Super Cache v | 选择 


插件 文件 


wp-super-cache/wp- 
cache.php 


wp-super-cache/advanced- 
cache.php 


Wp-super- 
cache/Changelog.txt 


WwWp-super-cache/ossd|- 
cdn.php 


wp-super- 

cache/plugins/awaitingmode 
ration.php 

wp-super- 

cache/plugins/badbehaviour 
php 

wp-super- 

cache/plugins/domain- 
mapping.php 


wp-super- 


Wordpress 添 加 分 类 目录 - Wordpress 教 程 

在 本 章 中 ， 我 们 将 研究 如 何 添加 WordPress 的 分 类 目录 。 分 类 目录 用 来 指示 你 的 网 站 ， 将 相关 
文章 帖子 分 类 。 它 排序 分 组 内 容 分 成 不 同 的 部 分 。 这 是 一 个 非常 方便 的 方式 来 组 织 文 章 。 

要 访 问 分 类 目录 部 分 ， 只 需 遵 遵循 以 下 步骤 : 


步骤 (1)- 在 WordPress 中 点 击 文章 > 分 类 目录 选项 。 
步骤 (2) : 接着 ， 所 示 显 示 分 类 目录 页 面 如 下 


以 下 是 关于 分 类 目录 的 字段 细节 。 
。 名 称 *:* 输入 分 类 目录 的 唯一 名 称 。 
别名 *:** 它 用 指定 在 分 类 的 URL 中 。 


。 父 节 点 *:** 分 类 目录 和 标签 不 同 ， 它 可 以 有 层级 关系 。 可 以 有 一 个 “音乐 ”分 类 目录 ， 在 这 
个 目录 下 可 以 有 叫做 “流行 "和 "古典 "的 子 目 录 。 


。 描述 *:* 加 入 分 类 目录 的 简要 说 明 。 它 是 任 选 的 。 描 述 只 会 在 一 部 分 主题 中 显示 。 
步骤 (3) : 填写 所 有 关于 分 类 的 信息 后 ， 单 击 添加 新 类 别 按钮 。 


步骤 (4) : 在 点 击 添加 新 分 类 目录 之 后 , 如 下 图 所 示 ， 新 创建 的 类 别 将 显示 在 页 面 右 侧 
中 。 

















































































































































































































Eis 十 新 建 您 好 ， admin 网 
显示 选项 帮助 
A Se 
分 类 目录 
搜索 分 类 目录 

添加 新 分 类 目录 批量 操作 Y ” 应 1 项 
名 称 名 称 图 像 描述 别名 总 数 

分 类 -1 cate-one 0 
这 将 是 它 在 站 点 上 显示 的 名 字 。 编辑 快速 编辑 

删除 查看 
别名 Uncategorized uncategorized 
“别名 "是 在 URL 中 使 用 的 别称 ， 它 可 以 令 URL 
更 美观 。 通 常 使 用 小 写 ， 只 能 包含 字母 ， 数 字 ， a 
en 名 称 图 像 描述 别名 总 数 

批量 操作 ” ”应 用 1 项 

艾 节点 
无 v 注意 : 
分 类 Bd 同 ， 它 可 以 有 层级 关系 。 您 ”删除 分 类 目录 不 会 把 该 分 类 目录 下 的 文章 一 并 暗 除 。 文 章 会 被 归 入 "Uncategorized" 分 
可 以 有 一 个 "音乐 "分 类 目录 ， 在 这 个 目录 下 可 类 目录 。 
以 有 人 亮 行 " 和 “古典 "的 子 目 录 。 分 类 目录 可 以 有 选择 的 转换 成 标签 ， 请 使 用 分 类 目录 到 标签 转换 器 。 
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Wordpress 编 辑 分 类 目录 - Wordpress 教 程 


在 本 章 中， 我 们 将 学 习 简 单 的 步骤 来 编辑 WordPress 中 的 分 类 目录 。 你 可 以 学 习 如 何在 创建 分 
类 目录 章节 在 Wordpress 添 加 分 类 目录 。 


以 下 是 简单 的 步 又， 在 WordPress 中 编辑 分 类 目录 。 


步骤 (1) : 在 WordPress 中 点 击 文章 -> 分 类 目录 。 






S 会 易 百 教程 ” 盟 十 新 建 您 好 ，admin 


伏 仪表 盘 仪表 盘 
首页 


更 新 


显示 选项 








欢迎 使 用 WordPress! 不 再 显示 
Ei 


向 ] 多 媒体 接 下 来 更 多 操作 

回 页 面 区 ”撰写 您 的 第 一 篇 博文 管理 边栏 小 工具 和 荣 音 
曙 评论 十 添加 ' 尖 于 ' 页 面 四 打开 /关闭 评论 功能 
A 回 查看 站 点 依 了 解 更 多 新 手 上 路 知识 
名 插件 

上 用 户 : 快速 草稿 

< 工具 1 画 1 个 页 面 标题 

ee 在 想 些 什么 ? 


@ 收 起 荣 单 Wordpress 4.3.1， 使 用 Twenty Fifteen 主 题 。 


步骤 (2) : 接 下 来 ， 你 可 以 查看 Category1 ( Category1 是 在 Wordpress 添 加 分 类 目录 本 
章 中 创建 )。 当 光标 甚 停 在 分 类 目录 上 ， 然 后 几 个 高 级 选项 显示 类 别名 称 的 下 面 。 进 行 编辑 分 
类 目录 有 两 种 方式 即 编辑 和 快速 编辑 : 


。 编辑 : 单 击 在 类 别 部 分 编辑 选项 ， 如 下 图 所 示 。 
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搜索 分 类 目录 
批量 操作 ” ， 应 用 2 项 目 
名 称 图 像 描述 别名 总 数 
Uncategorized uncategorized 1 
分 类 -1 cate-one 0 
央 速 编辑 晤 除 
名 称 图 像 描述 别名 总 数 
批量 操作 ” ， 应 用 2 项 目 
可 以 编辑 任何 必 填 字段 ， 然 后 点 击 更 新 按钮 ， 如 图 下 面 屏幕 。 
显示 选项 
编辑 分 类 目录 
名 称 分 类 -1 
这 将 是 它 在 站 点 上 显示 的 名 字 。 
别名 cate-one 
名 名 "是 在 URL 中 使 用 的 别称 ， 它 可 以 令 URL 更 美观 。 通 常 使 用 小 写 ， 只 能 包含 字母 , 数字 和 
连 字符 〈-) 。 
父 节点 无 Y 
分 类 目录 和 标签 不 同 , 它 可 以 有 层级 关系 。 您 可 以 有 一 个 “音乐 “分 类 目录 , 在 这 个 目录 下 可 以 
有 叫做 “流行 “和 "古典 "的 子 目录 。 
图 像 描述 


描述 只 会 在 一 部 分 主题 中 显示 。 


在 这 里 ， 分 类 字段 与 Wordpress 添 加 分 类 目录 中 的 字段 相同 。 
。 快速 编辑 : 点 击 快速 编辑 选项 分 类 目录 部 分 ， 如 下 图 所 示 。 
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搜索 分 类 目录 

批量 操作 ” ”应 用 2 项 目 
L 名 称 图 像 描述 别名 总 数 
Uncategorized uncategorized 1 
| cate-one 0 
| | 名 称 图 像 描述 别名 总 数 

批量 操作 ” ”应 用 2 项 目 


在 这 里 ， 你 只 能 编辑 如 下 图 所 示 的 分 类 目录 的 名 称 等 ， 然 后 点 击 更 新 分 类 按钮 。 


搜索 分 类 目录 

批量 操作 ” ”应 用 2 项 目 
L | 名 称 图 像 描述 别名 总 数 
Uncategorized uncategorized 1 


别名 cate-one 





取消 
L 名 称 图 像 描述 别名 总 数 


批量 操作 Y 应 用 2 项 目 
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Wordpress 删 除 分 类 目录 - Wordpress 教 程 


在 本 章 中 ， 我 们 将 学 习 研 究 如 何在 WordPress 中 删除 分 类 目录 。 你 可 以 学 习 如 何 创 建 类 别 : 
Wordpress 添 加 目录 分 类 


以 下 是 简单 的 步骤 ， 用 来 在 WordPress 删除 分 类 目录 。 


步 又 (1) : 在 WordPress 中 点 击 文章 -> 分 类 目录 。 








VE 十 新 建 您 好 ，admin 


显示 选项 帮助 


@ ta 仪表 盘 


欢迎 使 用 WordPress! 不 再 显示 
人 开 加 : 


接 下 来 更 多 操作 

加 ”撰写 您 的 第 一 篇 博文 管理 边栏 小 工具 和 菜单 

十 添加 ' 关 于 ' 页 面 罚 打开 /关闭 评论 功能 
办 》 加 查看 站 点 依 了 解 更 多 新 手 上 路 知识 
后 拓 
> | 快速 草稿 
£ 办 1 篇 文章 田 1 个 页 面 标题 
设 盟 1 条 评论 

在 想 些 什么 9 


WordpPress 4.3.1， 使 用 Twenty Fifteen 主 题 。 


© 


步骤 (2) : 接 下 来 ， 可 以 删除 分 类 -1 (这 是 在 WordPress 添 加 分 类 目录 这 一 章 中 所 创建 
的 ) 。 当 光标 巧 停 在 类 别 ， 然 后 几 个 高 级 选项 会 显示 在 类 别名 称 下 面 。 点 击 删 除 类 别 部 分 ， 
如 下 图 所 示 。 
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搜索 分 类 目录 
批量 操作 ” ”应 用 2 项 目 
名 称 图 像 描述 别名 总 数 
Uncategorized uncategorized 1 
分 类 -1 cate-one 0 
编辑 快速 编辑 
名 称 图 像 描述 别名 总 数 
批量 操作 ” ”应 用 2 项 目 


当 点 击 删 除 ， 会 得 到 一 个 阐 出 消息 ， 要 求 确认 删除 特定 分 类 目录 ， 如 下 图 所 示 。 


127.0.0.1 上 的 网 页 显示 : 


搜索 分 类 目录 


您 要 永久 删除 所 选项 目 。 
点 去 “取消 " 停止 ， 点 去 “确定 " 删除 。 2 项 目 





分 类 -1 cate-one 0 
编辑 快速 编辑 
查看 


名 称 图 像 描述 别名 总 数 


批量 操作 ” ， 应 用 2 项 目 


您 可 以 点 击 确定 按钮 ， 并 永久 删除 分 类 目录 。 
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在 本 章 中 ， 我 们 将 研究 如 何在 WordPress 中 添加 /发 布 文章 。 帖 子 也 被 称 为 文章 ， 有 时 也 被 称 
为 博客 或 博客 文章 。 这 些 都 是 用 来 推广 您 的 博客 。 


以 下 是 简单 的 步骤 来 在 WordPress 中 添加 /发 布 文章 。 


第 1 步 : 在 WordPress 中 点 击 文章 -> 写 文 章 。 







国 1 个 页 面 


用 Twenty Fifteen 主 题 © 














Hello world! 











由 Mr WordpPress 发 表 在 辟 Hello world! 大》 
Hi, this is acomment. To delete a comment just log in and view 
the posts comments. There YOU will have .… 


第 2 步 : 接 下 来 ， 将 获得 文章 的 编辑 页 面 ， 如 下 图 所 示 。 可 以 使 用 WordPress 的 所 见 即 所 得 
编辑 器 来 添加 您 的 文章 内 容 。 我 们 将 学 习 详 细 的 所 见 即 所 得 编辑 器 在 Wordpress 添 加 页 面 章 
节 中 。 


编 仪表 盘 撰写 新 文章 
准 文章 


文章 标题 - 关于 易 百 教程 


外 ] 添加 媒体 司 视 化 ”文本 





下 面 是 关于 易 百 教程 的 简要 描述 ， 


。 易 百 教程 是 因特网 上 最 大 的 IT 技 术 入 门 学 习 实 例 教程 和 实例 资源 网 站 
。 易 百 教程 是 完全 免费 的 

。 易 百 教程 是 非 盈 利 性 的 

。 易 百 教程 一 直 在 升级 和 更 新 





以 下 是 目前 在 添加 文章 页 面 编辑 器 页 面 中 的 字段 。 
。 文章 标题 : 输入 文章 标题 ， 如 POST1 
。 文章 内 容 : 输入 文章 的 内 容 

第 3 步 : 接 下 来 ， 点 击发 布 按钮 来 发 布 的 文章 。 





把 写 新 文章 





文章 标题 - 关于 易 百 教程 
.| 
“1 固定 链接 : http://127.0.0.1/2015/10/23/ 文 章 标题 -关于 易 百 教程 ， 编辑 保存 草稿 预览 
加 查看 文章 
?9 状态 : 草稿 编辑 

咎 ] 添加 媒体 可 视 化 ” 文本 @@ 公开 度 : 公开 编辑 
从 BT 二 注 二 66 一 三 三 三 只 党 三 。 的 立即 发 布 编 扣 
应 

二 移 至 回收 站 
所 下 面 是 天 于 易 百 教程 的 简要 描述 ， 

形式 

二 。 吻 百 教程 是 因特网 上 最 大 的 IT 技术 入 门 学 习 实例 教程 a 办 标准 
GS 和 实例 资源 网 站 日 志 

。 易 百 教程 是 完全 免费 的 图 像 

。 易 百 教程 是 非 盈利 性 的 视频 

轴 易 百 教程 一 直 在 升级 和 更 新 引 语 





以 下 是 几 个 选项 会 显示 在 发 表 部 分 。 


保存 草稿 *:** 它 保存 文章 后 成 稿 
预览 内 : 关 可 以 在 发 布 前 预览 您 的 文章 。 
移 到 废 纸 禾 六 :** 删除 文章 
状态 :更 改 后 行列 式 的 状态 : 发 布 ， 待 审 草案 
可 见 度 : 更 改 后 可 见 性 ， 即 公开 ， 私 人 或 密码 保护 
发 表 :更 改 后 发 表 文 章 的 日 期 和 时 间 


WordPress 编 辑 修 改 文章 - Wordpress 教 程 
在 本 章 中 ， 我 们 将 学 习 ， 如 何在 WordPress 中 编辑 修改 文章 。 可 以 先 学 习 如 何 新 增 文章 
Wordpress 新 添 文章 

以 下 是 简单 的 步骤 来 在 WordPress 编 辑 文章 /帖子 。 


步骤 (1) : 在 WordPress 中 点 击 文章 -> 所 有 文章 。 


步骤 (2) : 接 下 来 ， 你 可 以 查看 Post1 (Post1 是 在 Wordpress 添 加 文章 本 章 创建 ), 当 光 标 羡 停 
在 后 ， 几 个 高 级 选项 显示 在 文章 名 称 后 面 。 有 两 种 编辑 方式 ， 即 : 编辑 和 快速 编辑 。 


。 编辑 : 如 下 图 所 示 ， 点 击 POST1 的 编辑 选项 。 




























































































外 从 易 百 教程 上 曙 0 十 新 奸 | 
显示 选项 帮助 
顷 仪表 盘 文章 写 文 章 
准 文章 全 部 已 发 布 搜索 文章 
批量 操作 。 Y ， 应 用 全 部 日 期 "所 有 分 类 ”| 幕 选 至 3 项 
标题 作者 分 类 目录 标签 加 日 其 
POST1 admin 分 类 -1 一 一 1 分 钟 前 
央 速 编辑 垃圾 箱 查看 已 发 布 
加] 多 媒体 文章 标题 -关于 易 百 教程 i Es 16 小 时 前 
已 发 布 
明 评论 Hello world! admin Uncategorized ”一 加 | 2015-10- 
20 
分 外 观 已 发 布 
名 插件 标题 作者 分 类 目录 标签 蜀 日 其 
避 用 户 批量 操作  v 应 3 项 
”a 
图 设置 
EY 喜 评 弛 用 WordPress 进行 8 拖 。 有 





可 以 按 您 需要 编辑 或 更 改 内 容 或 标题 之 后 ， 然 后 点 击 更 新 按钮 ， 如 图 下 面 的 屏幕 。 


ED 十 新 建 ”查看 文章 您 好 ，admin 


























ee 显示 选项 帮助 
编辑 文章 瑟 文 章 
POST1 发 布 
固定 链接 : http://127.0.0.1/2015/10/23/post1/| 编辑 查看 文章 预览 更 改 
获取 短 链 接地 址 
9 状态 : 已 发 布 编辑 
钻 ] 添加 媒体 可 视 化 ”文本 号 公开 度 : 公开 编辑 
BT 三 三 人 6 一 三 三 三 四 流 三 冯 | 发 布 于 : 2015 年 10 月 23 日 @ 23:04 编辑 
移 至 回收 记 更 新 


这 是 一 个 测试 编写 文 


分 类 目录 








所 有 分 类 目录 最 常用 











Y| 分 类 -1 





Uncategorized 











+ 添加 新 分 类 目录 
。 快速 编辑 : 点 击 在 POST1 的 快速 编辑 选项 ， 如 下 图 所 示 。 
WE zt 十 新 建 您 好 ， admin 
显示 选项 帮助 
磺 仪表 盘 文章 加 - 
全 部 已 发 布 (3 搜索 文章 
批量 操作 ”应 用 全 部 日 期 ”” 所 有 分 类 v | 萍 选 目 3 项 目 
标题 作者 分 类 目录 标签 时 日 期 
POST1 admin 分 类 -1 一 一 4 分 钟 前 
编辑 | 快速 编辑 | 垃圾 箱 “查看 已 发 布 
文章 标题 - 关于 易 百 教程 admin 分 类 -1 加 - 16 小 时 前 
已 发 布 
Hello world! admin Uncategorized 一 国 2015-10- 
已 发 布 
标题 作者 分 类 目录 标签 外 日 期 
批量 操作 。 ” ”应 用 3 项 目 




















在 这 里 ， 您 可 以 编辑 文章 的 标题 ， 日 期 并 且 还 可 以 选择 文章 的 分 类 ， 如 下 图 所 示 ， 然 后 
点 击 更 新 按钮 。 


十 新 建 您 好 ， admin | 






























































显示 选项 帮助 
文章 写 文章 
全 部 | 已 发 布 搜索 文章 
批量 操作 ”应 用 全 部 日 期 ”所 有 分 类 ”| 入 先 目 3 项 目 
标题 作者 分 类 目录 标签 bg 日 期 
快速 编辑 分 类 目录 标签 
标题 POST1 Ucariied 
别名 post1 避 分 类 -1 
期 15 -十 vv -23 @23 Y| 允许 评论 LY| 允许 ping 
- 状态 “已 发 布 。， 站 畦 硕 这 入 文章 
密码 本 
私密 
取消 
文章 标题 - 关于 易 百 教程 admin 分 类 -1 = 





Hello world! admin Uncategorized ”一 国 2015-10- 





Wordpress 删 除 文 章 - Wordpress 教 程 


在 本 章 中 ， 我 们 将 学 习 如 何在 WordPress 中 删除 文章 。 可 以 学 习 如 何 添加 文章 在 Wordpress 
添加 文章 章节 。 


按照 以 下 步骤 在 WordPress 删 除 文章 。 


步骤 (1) : 在 Wordpress 中 点 击 文章 -> 所 有 文章 。 





司 省 wordpressi 全 4 腥 十 New 






OB Dashboard Dashboard 


Home 











Updates 属 


Welcome to WordPress! 


mm 二 mm 1 一 
QU SOMe IINKS LO ge 


op Media Add New 


Categorlies 
| Pages 
Tags (rouUr Site 
Comments 3 

于 Category Order 
me completely 






入 Appearance 


及 Plugins 大 


ss Users 






At a Glance yiibai. com 


步骤 (2) : 接 下 来 可 以 删除 POST1 (POST1 是 在 WordPress 添 加 文章 这 一 节 中 创建 的 ) ， 
当 光 标 荐 停 在 后 ， 在 POST1 下 方 显 示 那 几 个 高 级 选项 。 点 击 垃圾 箱 选项 删除 该 文章 。 


会 易 百 教程 ” 盟 十 新 建 您 好 ，admin 




















显示 选项 帮助 
文章 写 文章 
全 部 已 发 布 搜索 文章 
批量 操作 。 ” ”应 用 部 日 期 ”” 所 有 分 类 " ， 往 选 国 3 项 目 
标题 作者 分 类 目录 标签 Dg 日 期 
POST1 admin 分 类 -1 一 一 14 分 钟 前 
编辑 快速 编辑 垃圾 箱 此 者 已 发 布 
文章 标题 -关于 易 白 教程 admin 分 类 -1 = = 17 小 时 前 
已 发 布 
Hello world! admin Uncategorized 一 加 | 2015-10- 
已 发 布 
标题 作者 分 类 目录 标签 加 日 期 
批量 操作 。 Y ”应 用 3 项 目 
步骤 (3) : 接 下 来 ， 可 以 查看 您 的 文章 列表 以 确认 上 面 的 帖子 被 删除 。 
< 显示 选项 帮助 
文章 ” 写 文 章 
已 移动 1 篇 文章 到 回收 站 。 撤销 
全 部 (2) | 已 发 布 回收 站 划 家 文章 
批量 操作 。 ” ”应 用 全 部 日 期 ”” 所 有 分 类 ”| 节选 目 2 项 目 
标题 作者 分 类 目录 标签 晶 日 其 
文章 标题 - 关于 易 白 教程 admin 分 类 -1 2 2 17 小 时 前 
已 发 布 
Hello world! admin Uncategorized ”一 2015-10- 
DD > 
已 发布 
标题 作者 分 类 目录 标签 加 日 其 


批量 操作 。 ” 应 用 2 项 目 


Wordpress 了 预览 文章 - Wordpress 教 程 


在 本 章 中 ， 我 们 将 学 习 如 何在 WordPress 中 预览 文章 。 预 览 文章 是 查看 这 篇 文章 发 布 给 用 户 之 
前 。 安 全 预览 文章 ， 并 确认 在 看 后 是 否 要 发 布 到 网 站 上 。 可 以 根据 您 的 需要 编辑 在 预览 后 更 
改 后 。 


以 下 是 简单 的 步骤 来 在 WordPress 中 预览 文章 。 


步骤 (1) : 在 WordPress 中 点 击 文章 -> 所 有 文章 。 


或 者 可 以 直接 查看 您 的 文章 ， 当 编辑 时 点 击 预览 按钮 添加 后 如 下 图 所 示 


十 新 建 ”查看 文章 您 好 ，admin 网 























py 显示 选项 帮助 
编辑 文章 5 文章 
文章 标题 - 关于 易 百 教程 发 布 
固定 链接 : http://127.0.0.1/2015/10/23/about_ yiibai/ 编辑 | 查看 文章 预览 更 改 
获取 短 链 接地 址 
?9 状态 : 已 发 布 编辑 
馈 ] 添加 媒体 可 视 化 ”文本 > 公开 度 : 公开 编辑 
Be 三 由 三 二 新 一下 三 本 三 中 三 贡 办 下 三 也 揭 发 布 于 : 2015 年 10 月 23 日 @ 06:45 编辑 
gp asp 移 至 回收 站 更 新 
下 面 是 关于 易 百 教程 的 简要 描述 ， 
。 易 百 教程 是 因特网 上 最 大 的 IT 技术 入门 学 习 实例 教程 分 类 目录 
和 实例 资源 网 站 所 有 分 类 目录 ”最 常用 
。 易 百 教程 是 完全 免费 的 
。 易 百 教程 是 非 便利 性 的 习 4 类 1 
。 易 百 教程 一 直 在 升级 和 更 新 EY 





:nF 来 归 忆 


步骤 (3) : 接 下 来 ， 当 你 点 击 观看 或 预览 ， 可 以 查看 您 的 文章 如 下 图 所 示 。 


Ni 


雹 易 百 教程 Jf 自 定义 明 十 新 建 ” 编辑 文章 您 好 ， admin 





文革 标题 -关于 另 百 教程 


下 面 是 关于 易 百 教程 的 简要 描述 : 
。 易 百 教程 是 因特网 上 最 大 的 IT 技术 入 门 学 习 实例 教程 和 实例 资源 网 站 
。 易 百 教程 是 完全 免费 的 
文章 标题 - 关于 易 百 教程 。 易 白 教 程 是 非 归 利 性 的 


。 吻 白 教程 一 直 在 升级 和 更 新 


Hello world! 


近期 评论 


Mr WordPress 发 表 在 你 Hello 


rorld!» 国 十 月 23,2015 名 admin 加 分 类 -1 依 编 辑 
world!’» 


Wordpress 发 布 文章 - Wordpress 教 程 


在 本 章 中 ， 我 们 将 学 习 如 何在 WordPress 中 发 布 文章 。 发 布 是 用 来 提供 给 所 有 用 户 ， 每 个 用 户 
都 可 以 查看 某 个 文章 的 发 布 。 在 WordPress 发 布 一 个 新 的 文章 是 一 个 简单 的 过 程 。 


下 面 是 在 WordPress 发 布 文章 的 步 又 。 


第 1 步 : 在 WordPress 中 点 击 文章 -> 写 文 章 。 





您 好 ，admin 






本 标题 


在 想 些 什么 ? 
用 Twenty Fifteen 主 题 。 


文章 标题 - 关于 易 百 教程 


Hello world! WordPress 新 闻 





WordPress 4.3“Billie” 八 月 20, 2015 
Vordpress 4.3 简 体 中 文 版 现 已 开放 下 载 

















Mr WordPress 发 表 在 人 Hello world! # 六 


Hi, this is a comment. To delete a comment just WPTavern: Nikhil Vimal Acquires Front End Registration 
og in and view the post's comments. There you 














and Login Forms Plugin From Pippin Williamson 


will have .… 


第 2 步 : 接 下 来 ， 将 获得 文章 的 编辑 页 面 ， 如 下 图 所 示 。 您 可 以 使 用 WordPress 的 所 见 即 所 
得 的 编辑 器 添加 /编写 文章 的 内 容 。 









固定 链接 : http://127.0.0.1/2015/10/24/ 这 是 一 个 出 试 文章 标题 /， 编 辑 
查看 文章 


后 ] 添加 媒体 


可 视 化 文本 
B T “ec| 三 | 三 66 一 三 三 三 哨 六 三 置 芝 


下 面 是 关于 易 百 教程 的 简要 描述 ， 








易 百 教程 是 因特网 上 最 大 的 IT 技术 入 门 学 习 实例 教程 
和 实例 资源 网 站 

易 百 教程 是 完全 免费 的 
易 

易 

















百 教程 是 非 盈 利 性 的 
教程 一 直 在 升级 和 更 新 





















点 击 发 布 按钮 来 发 布 文章 。 
十 新 建 
撰写 新 文章 


这 是 一 个 测试 文章 标题 


固定 链接 : http://127.0.0.1/2015/10 


/24/ 这 是 一 个 测试 文章 标题 /| 编辑 





查看 文章 
多 添加 媒体 可 视 化 文本 
B I .ee| 三 | 三 6 一 王 三 三 几 澡 三 针头 











下 面 是 天 于 易 百 教程 的 简要 描述 ， 





。 易 百 教程 是 因特网 上 最 大 的 IT 技术 入 门 学 习 实例 教程 
和 实例 资源 网 站 

易 百 教程 是 完全 免费 的 

易 百 教程 是 非 盈利 性 的 

易 百 教程 一 直 在 升级 和 更 新 























点 击 发 表 后 您 的 文章 得 以 发 表 ， 供 用 户 查看 。 





您 好 ， admin | 


显示 选项 帮助 


发 布 


保存 草稿 


oj 
"aN 
中 


9 状态 : 草稿 编辑 


人 @@ 公开 度 : 公开 编辑 


条 立即 发 布 编辑 
移 至 回收 站 
分 类 目录 


所 有 分 类 目录 ”最 常用 


Uncategorized 


+ 添加 新 分 类 目录 
您 好 ，admin 网 
显示 选项 帮助 
发 布 
保存 草稿 预览 


[ 立即 发 布 编辑 
移 至 回收 站 发 布 
分 类 目录 


所 有 分 类 目录 ”最 常用 


Uncategorized 


分 类 -1 


分 基 - 
+ 添加 新 分 类 目录 


WordPress 煤 体 库 - Wordpress 教 程 


在 本 章 中 ， 我 们 将 了 解 WordPress 中 的 媒体 库 。 媒 体 库 包括 图 像 ， 音 频 ， 视 频 和 文件 ， 可 以 
写 一 个 文章 或 网 页 时 上 传 并 添加 到 内 容 中 。 在 这 里 可 以 看 到 ， 添 加 ， 编 辑 或 删除 任何 媒体 相 
关 的 对 象 如 果 没 有 必要 时 。 


下 面 是 了 解 有 关 媒 体 库 的 步骤 。 


步骤 (1) : 在 WordPress 中 点 击 多 媒体 -> 媒体 库 。 







便 易 百 教程 ” 明 十 新 建 您 好 ， admin 


加 1 个 页 面 


用 Twenty Fifteen 主 题 。 


文章 标题 - 关于 易 百 教程 草稿 


Hello world! 这 是 一 个 测试 文章 标题 十 月 24, 2015 
下 面 是 关于 易 百 教程 … 


Yb 


Mr Wordpress 发 表 在 辟 Hello world! # 、 
由 Mr WordPress 发 表 在 避 Hello world! # WordPress 新 闻 
Hi, this is a comment. To delete a comment, just 


二 | 


log in and view the posts comments. There you WordPress 4.3"Billie” 八 月 20, 2015 


ordPress 4.3 简 体 中 文 版 现 已 开放 下 载 


步骤 〈2) : 接 下 来 ， 可 以 看 到 如 图 像 ， 音 频 ， 视 频 媒 体 文件 。 单 击 添加 媒体 按钮 。 


全 


will have .… 





9 Et 十 新 建 您 好 ， admin 


名 仪表 盘 媒体 EE 
准 文章 
中] 多 媒体 
操 体 库 


地 加 


帮助 


困 。 所 有 多 媒体 项 目 * ”全 部 日 期 ” ” 批 里 选择 





转 页 面 





TutorialsPoint 后 端 教程 


步骤 3) : 接 下 来 ， 获 取 显 示 上 传 新 媒体 页 面 。 可 以 了 解 如 何 添加 媒体 在 WordPress 添 加 媒 
体 。 

















帮助 ， 
媒体 库 
图 田 ” 所 有 多 媒体 项 目 "全 部 日 期 " ， 批 里 选择 搜索 
1 * XxX 
拖 文件 到 任何 地 方 来 上 伟 
. 选择 文件 
最 大 上 传 文件 大 小 : 2 MB。 
步骤 (4) : 接 下 来 ， 可 以 看 到 一 些 工具 条 ， 如 下 图 所 示 。 
所 有 多 媒体 项 目 "| 全 部 日 期 " ”批量 选择 搜索 
所 有 多 媒体 项 目 
1 一 一 一 | 图像 
音 和 x 
: 视频 拖 文件 到 任何 地 方 来 上 传 
尚未 附加 
重 或 
。 列表 视图 : 显示 图 像 和 视频 在 列表 形式 。 
显示 选项 Y 帮助 ” 
媒体 库 添加 
围 田 全 部 (3) v 全 部 日 期 ”vr 总 选 机 志 
批量 操作 " ”应 用 3 项 目 
文件 作者 上 传 至 外 日 期 
20151024171149 admin (尚未 附加 ) 一 1 分 钟 前 
20151024171149.png 现在 附加 到 文章 
或 页 面 
1024171115 admin (尚未 附加 ) 一 1 分 钟 前 
| 1024171115.png 现在 附加 到 文章 
或 页 面 
加 24171132 admin (尚未 附加 ) 一 1 分 钟 前 
现在 附加 到 文章 
(hd) 24171132.png tie 
文件 作者 上 传 至 加 日 其 
批量 操作 ”应 用 3 项 目 


WordPress 媒 体 库 - Wordpress 教 程 214 


TutorialsPoint 后 端 教程 


。 网 格 视图 : 以 网 格格 式 显 示 所 有 图 像 ， 如 下 图 所 示 。 


媒体 库 


习 国 | gH ， 全 部 日 期 ” ， | 批 里 选 反 搜索 





。 过 滤 图 像 和 视频 它 过 滤 图 像 和 视频 。 
。 搜索 框 : 通过 将 名 称 在 框 中 搜索 特定 的 图 像 。 
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Wordpress 添 加 媒体 - Wordpress 教 程 


在 本 章 中 ， 我 们 将 学 习 如 何在 WordPress 中 添加 媒体 文件 。WordPress 人 允许 你 添加 类 似 视 
频 ， 音 频 和 图 像 的 媒体 文件 。 


按照 以 下 步 又 来 添 加 媒体 。 


步骤 (1) : 在 WordPress 中 点 击 媒体 -> 添加 。 





洛 易 百 教程 ” 明 







显示 选项 


仪表 盘 
概览 快速 草稿 
本 2 篇 文章 转 1 个 页 面 标题 





明 1 条 评论 
_ 在 想 些 什么 ? 
用 Twenty Fifteen 主 题 。 


文章 标题 - 关于 易 百 教程 草稿 


Hello world 这 是 一 个 测试 文章 标题 十 月 24, 2015 
下 面 是 关于 易 百 教程 … 























Mr WordPress 发 表 在 人 Hello world! # 闪 、 
生生 作 NG Oo WordPress 新 闻 
comment. To delete a comment, just 
og in and view the post's comments. There you Wordpress 4.3“Billie” 作 月 20, 2015 
will have .… Se > Tv 


Wordpress 4.3 漳 体 中 文 版 现 已 开放 下 载 。 
步骤 〈2) : 接 下 来 ， 点 击 选择 文件 选项 从 本 地 存储 选择 ， 如 下 图 所 示 的 文件 。 
WE 十 新 建 您 好 ， admin 


网 仪表 盘 上 传 新 媒体 文件 





您 正在 使 用 多 文件 上 传 工 具 。 遇 到 问题 ? 请 尝试 使 用 标准 浏览 器 上 人 苇 工 具 。 
最 大 上 传 文件 大 小 : 2 MB。 











步骤 〈3) : 接 下 来 ， 选 择 添加 媒体 文件 如 下 图 所 示 ， 如 图 像 和 音频 。 


您 好 ，admin 


















































帮助 
© 打开 Ny 
GO ， 易 百 教程 图 片 
组 织 ~ 新 建文 件 夫 
县 Administrator “^ 
加 计算 机 
1024171115.pn ”2015102417114 。” 原 Logo.png 
9 9.png 
昏 DVD RW 驱动 
售 网 络 
园 控制 面板 
司 回收 站 
是 暴 再 教程 图 片 ” 
文件 名 (N): 
步骤 〈4) : 接着 ， 可 以 查看 添加 后 的 媒体 文件 的 列表 ， 如 下 所 示 。 
十 新 建 您 好 ，admin 
显示 选项 帮助 
媒体 库 系 m 
ee 全 部 (3) ” 全 部 日 期 v 沁 选 
自 ] 多 媒体 
批量 操作 ”应 用 3 项 
文件 作者 上 传 至 饭 日 期 
| 20151024171149 admin (尚未 附加 ) 三 13 分 钟 前 
20151024171149.png 现在 附加 到 文章 
或 页 面 
1024171115 admin {尚未 附加 ) 一 13 分 钟 前 
1024171115.png 现在 附加 到 文章 
或 页 面 
24171132 admin (尚未 附加 ) 一 13 分 钟 前 
24171132.png 现在 附加 到 文章 
或 页 面 
文件 作者 上 传 至 者 日 期 























WordPress 插 入 媒体 - Wordpress 教 程 


在 本 章 中 ， 我 们 将 学 习 如 何在 WordPress 中 插入 传媒 。 媒 体 文件 可 以 从 本 地 存储 或 从 网 址 插入 
到 您 网 页 或 文章 。 


按照 以 下 在 WordPress 中 插入 媒体 的 步骤 。 


步骤 (1) : 在 WordPress 点 击 文章 -> 写 文章 





您 好 ， admin 





快速 草稿 






图 1 个 页 面 标题 


在 想 些 什么 ? 
用 Twenty Fifteen 主 题 。 























文章 标题 - 关于 易 百 教程 草稿 
Hello world! 这 是 一 个 测试 文章 标题 十 月 24, 2015 





下 面 是 关于 易 百 教程 … 














Mr Wordpress 发 表 在 尺 Hello world! 大 > 
Mr WordPress 发 表 在 攻 Hello world! # WordpPress 新 闻 
Hi, this is a comment. To delete a comment just 








og in and view the post's comments. There you Wordpress 4.3"Billie” 八 月 20, 2015 


Press 4.3 简 体 中 文 版 现 已 开放 下 载 


will have ... 





步骤 〈《2) : 接 下 来 ， 单 击 添加 媒体 。 


本 | tarialcDAint F Df 
ULOTIalISF OINL 和 虽 业 8 了 人 41 


= - 您 好 ， admin 








撰写 新 文章 
在 此 输入 标题 发 布 i 
保存 草稿 预览 
久 ] 添加 召 休 可 视 化 ”文本 ne ne 
至 本 = . @ 公开 度 : 公开 编辑 
B Te 三 上 E(k- 三 三 三 6 六 三 十 XX 











莘 立即 发 布 编辑 


移 至 回收 站 发 布 


分 类 目录 ^ 
所 有 分 类 目录 最 常用 


Uncategorized 


分 类 -1 
十 添加 新 分 类 目录 


步骤 〈3) : 可 以 从 媒体 库 选 项 卡 中 选择 文件 ， 如 下 图 所 示 。 


插入 多 媒体 插入 多 媒体 和 


创建 相册 上 传 文件 ”媒体 库 


特色 图 片 a 
所 有 多 媒体 ” 全 部 日 期 | 


| 20151024171149.png 
| 十 月 24, 2015 

| 213kB 

有 311 x 400 

编辑 图 像 

永 名 用 除 


从 URL 插 六 








URL | http://127.0.0.1/wp-conte! 





标题 “20151024171149 


说 明 





图 像 描述 ~ 


个 | 
i 
天空 


关于 所 选择 的 媒体 文件 的 信息 ， 将 显示 在 屏幕 右 侧 的 附件 详细 下 。 单 击 插入 至 文章 ， 图 像 将 
被 插入 到 文章 。 在 附件 详细 信息 部 分 ， 可 看 到 如 URL， 标 题 ， 图 片 说 明 ， 蔡 换文 本 和 描述 的 
图 像 信 息 。 或 者 可 以 直接 从 系统 通过 对 已 上 传 文件 选项 卡 插入 图 片 。 点 击 插入 至 文章 按钮 。 





( 
Vv 
DN 


TutorialsPoint 后 端 教程 


插入 多 媒体 插入 多 媒体 ” 
创建 相册 上 传 文件 ”媒体 库 
特色 图 片 
从 URL 插 入 
拖 文 件 到 任何 地 方 来 上 传 


或 


选择 文件 


最 大 上 传 文件 大 小 : 2 MB。 
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WordPress 编 辑 媒 体 - Wordpress 教 程 


在 本 章 中 ， 我 们 将 学 习 如 何 编辑 WordPress 中 的 媒体 。 可 以 管理 所 有 关于 你 的 媒体 ， 保 存在 媒 
体 库 中 的 信息 。 


以 下 是 WordPress 中 编辑 媒体 的 步骤 。 


步骤 (1) : 点 击 多 媒 ** 体 -> 媒体 ** 库 ， 然 后 单 击 媒体 项 目 或 编辑 链接 的 名 称 。 





您 好 ， admin 





快速 草稿 






ep 
怀 融 


在 想 些 什么 3 
用 Twenty Fifteen 主 题 。 


文章 标题 - 关于 易 百 教程 草稿 


Hello world! 这 是 一 个 测试 文章 标题 十 月 24, 2015 
下 面 是 天 于 易 百 教程 .. 





























Mr Wordpress 发 表 在 长 Hello world! 大 。 
由 Mr WordPress 发 表 在 攻 Hello world! # Wordpress 新 闻 
Hi, this is a comment. To delete a comment, 
just log in and view the post's comments WordPress 4.3"Billie” 八 月 2 015 


There you will have .… i 
ordPress 4.3 漳 体 中 文 版 现 已 开放 下 载 。 


步骤 〈2) : 浏览 的 媒体 文件 列表 。 选 择 任意 一 个 图 像 编辑 。 


TutorialsP 


会 易 百 教程 


步骤 〈3) : 接 下 来 ， 可 以 在 右 侧 几 个 选项 查看 编辑 媒体 页 面 。 


oInt 后 是 


和 








十 新 建 
媒体 库 添加 


田 ” 所 有 多 媒体 项 目 " 





编辑 图 像 





全 部 日 期 ”" ， 批量 选择 


。 URL*:* 可 以 从 一 个 链接 读 取 媒体 文件 。 





文件 名 : 24171132.png 
文件 类 型 : image/png 

上 传 于 : 十 月 24, 2015 

文件 大 小 : 128 kB 

分 状 率 : 332 x 272 


URL http://127.0.0.1/wp-conter 


标题 24171132 


上 传 者 为 ”admin 


查看 附件 页 面 | 编辑 详细 信息 | 永久 删除 


。 标题 *:** 这 显示 了 媒体 的 名 称 。 标 题 通常 以 画 亡 和 附件 页 面 上 显示 ， 如 果 主 题 或 插件 设 


、 一 
计 显 示 已 o 


。 蔡 代 文本 *:* 图 像 的 alt 文本 ， 这 是 用 于 描述 媒体 。 用 于 可 用 性 。 
。 图 像 描述 : 媒体 文件 的 解释 。 


Nd 
VVordPress: 铅 牧 






示 体 - Wordpress 





DD 


TutorialsPoint 后 端 教程 


。 永久 删除 : 永久 删除 您 的 媒体 文件 。 
步骤 〈4) : 完成 编辑 所 需 的 字段 后 ， 图 像 抽 做 的 更 改 会 自动 保存 。 


文件 名 : 24171132.png 
文件 类 型 : image/png 
上 人 苇 于 : 十 月 24, 2015 
文件 大 小 : 128 kB 

分 状 率 : 332 x 272 





URL http://127.0.0.1/wp-cont 
标题 “24171132 


说 明 ”测试 图 片 说 明 





车 代 文 本 
编辑 图 像 图 像 描述 ” 朝 素 幕 楚 


上 传 者 为 “admin 
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WordPress 添 加 页 面 - Wordpress 教 程 


在 本 章 中 ， 我 们 将 学 习 如 何在 WordPress 中 添加 页 面 。 添 加 页 面 类 似 于 WordPress 的 增加 文 
章 。 页 内 页 面 是 静态 内 容 往 往 不 是 经 常 改 变 其 显示 的 信息 。 


以 下 是 在 WordPress 中 添加 页 面 的 简单 步骤 。 


步骤 (1) : 点 击 页 面 -> 新 建 页 面 ， 如 下 图 所 示 。 









您 好 ，admin 


快速 草稿 


办 2 篇 文章 回 1 个 页 面 标题 


在 相 些 什么 3 
Wordpress 4.3.1， 使 用 Twenty Fifteen 主 题 。 


文章 标题 - 关于 易 百 教程 草稿 


Rellowors 这 是 一 个 测试 文章 标题 十 月 24, 2015 
下 面 是 关于 易 百 教程. 














WordPress 新 闻 


i, this is a com 
ust log in and view the post's comments. 
There you will have .… 





WordPress 4.3”Billie” 八 月 20, 2015 
Press 4.3 漳 体 中 文 版 现 已 开放 下 载 





步骤 〈2) : 接 下 来 ， 将 得 到 编辑 的 页 面 ， 如 下 图 所 示 。 在 下 面 的 图 片 可 以 看 到 ， 在 编辑 器 页 
面 有 两 个 标签 ， 视 觉 和 文本 。 在 这 里 可 以 插入 两 种 文本 。 在 这 里 ， 我 们 将 学 习 有 关 将 文本 转 
换 成 可 视 格式 。 





需要 
洒 沁 





以 下 是 在 添加 新 页 面 编辑 器 页 面 中 的 字段 的 详细 信息 。 
标题 


创建 页 面 


关于 易 百 教程 

















它 用 于 写 文 章 ， 这 是 在 页 面 上 之 后 显示 标题 。 


您 好 ，admin 


要 帮助 ? 请 点 击 页 面 右 上 角 的 “帮助 "选项 


固定 链接 示 出 了 用 于 下 文 的 标题 的 页 面 潜在 的 网 址 。 这 个 URL 是 按照 给 定 的 标题 生成 。 


WYSIWYG 编辑 二 


这 是 一 个 所 见 即 所 得 的 编辑 器 ， 这 类 似 我 们 编辑 文章 的 内 容 文字 处 理 器 接口 。 


久 ] 添加 媒体 可 视 化 文本 








下 面 是 目前 所 见 即 所 得 的 编辑 器 的 选项 


粗 体 按钮 : 用 于 加 粗 字 体 。 

斜体 : 用 于 斜体 字体 。 

项 目 符号 列表 : 它 增 加 了 项 目 符号 的 内 容 。 

编号 列表 : 这 可 以 添加 数字 内 容 的 列表 。 

大 段 引 用 : 它 引 用 文字 。 

水 平分 割 线 : 创建 一 个 横 线 在 句子 之 间 。 

左 对 齐 : 将 在 页 面 左 侧 对 齐 内 容 。 

右 对 齐 : 设置 内 容 的 页 面 右 侧 对 齐 。 

对 齐 : 设置 在 页 面 的 中 心 对 齐 内 容 。 

添加 链接 : 它 允 许 添加 一 个 链接 到 您 的 内 容 。 当 点 击 这 个 按钮 ， 显 示 以 下 页 面 。 
插入 或 编辑 链接 x 


输入 目标 URL 


URL 


链接 文本 





在 新 窗口 或 标 答 页 打开 链接 


或 链接 到 站 点 中 的 内 容 


文本 插入 


发 布 


发 布 页 面 到 网 站 上 给 用 户 。 


页 面 属性 


页 面 属 性 模块 允许 您 选择 的 父 级 页 面 为 特定 页 面 。 还 可 以 设置 顺序 页 面 。 


艾 级 
(无 父 级 ) v 
排序 
0 
需要 帮助 ? 请 点 击 多 面 右上 前 的 “帮助 "选项 


SE 


。 顺序 : 设置 页 面 的 顺序 。 


特色 图 像 


它 包 括 在 网 页 中 的 图 像 。 


WordPress 发 布 页 面 - Wordpress 教 程 


在 本 章 中 ， 我 们 将 学 习 如 何在 WordPress 发 布 页 面 。 发 布 提供 给 所 有 用 户 ， 使 得 每 个 用 户 可 
以 查看 该 特定 页 面 的 页 面 。 在 WordPress 发 布 一 个 新 的 页 面 是 一 个 简单 的 过 程 。 
按照 以 下 步骤 来 在 WordPress 中 发 布 页 面 


第 1 步 : 在 WordPress 中 点 击 页 面 -> 新 建 页 


第 2 步 : 接 下 来 得 到 编辑 器 ， 如 下 图 所 示 。 可 以 使 用 WordPress 的 所 见 即 所 得 编辑 器 来 添加 
您 的 网 页 的 实际 内 容 。 


创建 页 面 
关于 WordPress 


固定 链接 : http://127.0.0.1/ 关 于 wordpress/， 编辑 | 查看 页 面 


号] 添加 媒体 可 视 化 文本 


B Tw 三 三 和 二 三 三 三 有 这 王国 





Wordpress 是 一 种 使 用 PHP 语 言 开 发 的 博客 平台 ， 用 户 可 以 
在 支持 PHP 和 和 MySQL 数据 库 的 服务 器 上 架设 属于 自己 的 网 
站 。 也 可 以 把 WordPress 当 作 一 个 内 容 管理 系统 (CMS) 来 
使 用 。 

WordPress 是 一 款 个 人 博客 系统 ， 并 逐步 演化 成 一 款 内 容 管 
理 系 统 软件 ， 它 是 使 用 PHP 语 言 和 MySQL 数 据 库 开 发 的 。 用 
户 可 以 在 支持 PHP 和 MySQL 数据 库 的 服务 器 上 使 用 自己 的 
博客 。 


字数 统计 : 183 草稿 保存 于 上 午 11:01:45。 





第 3 步 : 如 下 图 所 示 接 下 来 ， 点 击发 布 按钮 。 


洛 易 百 教程 ” 明 十 新 建 您 好 ， admin | 


显示 选项 帮助 
创建 页 面 
关于 WordPress 发 布 
保存 草稿 预览 
a 9 状态 : 草稿 编辑 
馈 ] 添加 媒体 可 视 化 文本 
2 Es 全 公开 度 : 公开 编辑 
BT 三 三 6 一 三 三 三 哨 澡 三 置 2 





[0 立即 发 布 编辑 





Wordpress 是 一 种 使 用 PHP 语 言 开 发 的 博客 平台 ， 用 户 可 以 











移 至 回收 沾 发 
外 观 在 支持 PHP 和 和 MySQL 数据 库 的 服务 器 上 架设 属于 自己 的 网 
i 插件 站 。 也 可 以 把 WordPress 当 作 一 个 内 容 管理 系统 (CMS) 来 

使 用 。 页 面 属性 
人 Wordpress 是 一 款 个 人 博客 系统 ， 并 未 步 演化 成 一 款 内 容 管 se 
工具 理 系统 软件 ， 它 是 使 用 PHP 语 言 和 MySQL 数 据 库 开发 的 。 用 pr - 
设 户 可 以 在 支持 PHP 和 MySQL 数据 库 的 服务 器 上 使 用 自己 的 0 
es 博客 。 排序 

0 


需要 帮助 ? 请 点 击 页 面 右 上 和 角 的 “帮助 "选项 
卡 。 





字数 统计 : 183 草稿 保存 于 上 午 11:00:31。 


点 击 后 发 布 后 您 的 文章 得 以 发 表 ， 供 用 户 查 看 。 


WordPress 编 辑 页 面 - Wordpress 教 程 
在 本 章 中 ， 我 们 将 研究 如 何 来 编辑 WordPress 的 页 面 。 你 可 以 学 习 如 何 添加 页 面 在 
WordPress 添 加 页 面 。 


步骤 (1) : 在 WordPress 点 击 页 面 -> 所 有 页 面 ， 如 下 图 所 示 。 


步骤 (2) : 接 下 来 ， 可 以 查看 关于 我 们 (关于 我 们 已 在 WordPress 添 加 页 面 这 一 章 中 创 
建 ) 。 当 光标 其 停 在 页 面 ， 然 后 选择 几 个 选项 得 到 下 面 关于 我 们 的 显示 。 之 后 编辑 它们 ， 即 
编辑 和 快速 编辑 两 种 方式 。 


。 编辑 : 点 击 编辑 选项 天 于 我 们 如 下 图 所 示 。 









































国 全 易 下 教程 明 0 十 新建 您 好 ，admin 
i 显示 选项 帮助 
蜗 仪表 盘 页 面 新 建 页 面 
全 部 已 发 布 | 草稿 搜索 页 面 
批量 操作 "应 全 部 日 期 ”” ， 误 选 3 项 
标题 作者 。 音 日 其 
Sample Page admin 一 2015-10- 
20 
已 发 布 
关于 WordPress admin 一 2 小 时 前 
已 发 布 
关于 易 白 教程 - 草稿 admin 一 2015-10- 
[篇 辐 | 居 过 编辑 ”垃圾 和 上 24 
最 后 修改 
标题 作者 。 音 日 其 
批量 操作  ” ”应 用 项 目 





可 以 编辑 或 更 改 网 页 内 容 或 标题 按 ， 然 后 点 击 更 新 按钮 ， 如 下 面 的 图 。 





固定 链接 : http://127.0.0.1/ 关 于 易 百 教程 / 4 
获取 短 链接 地 址 


自 ] 添加 媒体 


程 和 实例 资源 网 站 
。 易 白 教程 是 完全 免费 的 
。 吻 百 教程 是 非 盈利 性 的 
。 易 百 教程 一 直 在 升级 和 更 新 





。 快速 编辑 : 单 击 快速 编辑 选项 关于 我 们 如 下 图 所 示 。 


?9 状态 : 已 发 布 编辑 





可 视 化 ”文本 > 公开 度 : 公开 编辑 
I 的 - 三 三 三 小 宇 = 前 发 布 于 : 2015 年 10 月 24 日 @ 14:04 编辑 














称 至 回收 站 


页 面 属性 


。 易 百 教程 是 因特网 上 最 大 的 IT 技 术 入 门 学 习 实例 教 


父 级 
(无 父 级 ) m 
排序 


在 这 里 ， 您 可 以 编辑 标题 和 关于 我 们 页 面 的 日 期 ， 也 可 以 选择 父 页 面 ， 如 下 图 所 示 ， 然 


后 点 击 更 新 按钮 。 


四 十 新 建 
































关于 WordPress 

快速 编辑 

标 是 关于 易 百 教程 

别名 关于 易 百 教程 

日 期 2015 十 vwFl24 4 :04 
明 评论 密码 -性 [| 私密 
外 外 观 
必 插件 
吕 用 户 标题 
矿工 具 批量 操作  ， 应 用 


厂 诗 纱 万 Wordpress 浊 行凶 从。 





您 好 ,， admin 图 
已 发 布 
admin 一 2 小 时 前 
已 发 布 
级 主页 面 无 父 级 〉 
排序 0 
模板 M 
人 允许 评论 
状态 已 发 布 
更 新 
作者 bg 日 期 
3 项 目 


WordPress 删 除 页 面 - Wordpress 教 程 


在 本 章 中 ， 我 们 将 学 习 如 何在 WordPress 中 删除 页 面 。 你 可 以 学 习 如 何 添 加 页 面 在 
WordPress 添 加 页 面 章节 。 


按照 以 下 步骤 删除 WordPress 的 页 面 。 


第 1 步 : 在 WordPress 中 点 击 页 面 -> 所 有 页 面 。 


第 2 步 : 接 下 来 ， 可 以 删除 示例 页 面 (示例 页 面 是 WordPress 创 建 默 认 的 ) 。 当 光标 县 停 在 网 
页 ， 几 个 选项 显示 在 示例 页 面 的 下 面 。 点 击 垃圾 箱 选项 删除 该 文章 页 面 。 






































SN 便 易 百 教程 ” 明 十 新 建 您 好 ,， admin 国 
三 显示 选项 帮助 
侈 仪表 盘 页 面 ”基建 页面 
六 文 全 部 (3) | 已 发 布 (: 2 
9 批量 操作 ”应 全 部 日 期 ” ”当选 3 项 
标题 作者 bg 日 期 
Sample Page admin 一 2015-10- 
已 发 布 
关于 WordPress admin 一 2 小 时 前 
编辑 快速 编 辑 | 垃圾 条 | 看 已 农 布 
关于 易 百 教 程 admin 一 9 分 钟 前 
已 发 布 
标题 作者 bg 日 期 
批量 操作 。 应 用 Ee 








或 者 可 以 直接 删除 页 面 ， 同 时 编辑 或 点 击 移动 网 页 添加 到 垃圾 桶 ， 如 下 图 所 示 : 


”会 易 百 教程 十 新 建 查看 页 面 您 好 ,admin 国 


本 显示 选项 帮助 
侈 仪表 盘 编辑 页 面 ” 新 娃 页 面 
关于 WordPress 发 布 
加 各 霸 江 
re 
固定 链接 : http://127.0.0.1/ 关 于 wordpress/ 编辑 ” 查看 页 面 预览 更 改 
获取 短 馆 接地 址 
?9 状态 : 已 发 布 编辑 
身 ] 添加 媒体 可 视 化 ”文本 他 公开 度 : 公开 编辑 


BT DE6- 三 三 三 @ 由 三 芝 贞 发 布 于 : 2015 年 10 月 24 日 @ 12:13 编辑 


2 移 至 回收 站 


WordPress 是 一 种 使 用 PHP 语 言 开发 的 博客 平台 ， 





用 户 可 以 在 支持 PHP 和 MYyYSQL 数 据 库 的 服务 器 上 页 面 属性 

架设 属于 自己 的 网 站 。 也 可 以 把 WordPress 当 作 必 级 

一 个 内 容 管理 系统 (CMS) 来 使 用 。 

Wordpress 是 一 款 个 人 博客 系统 ， 并 逐步 演化 成 一 CEX 级 ) _， 
款 内 容 管 理 系统 软件 ， 它 是 使 用 PHP 语 言 和 排序 
MYVSQL 数 据 库 开发 的 。 用 户 可 以 在 支持 PHP 和 


第 3 步 : 接 下 来 ， 以 确认 已 删除 的 页 面 ， 查 看 您 的 网 页 列表 。 


十 新 建 您 好 ， admin 
显示 选项 帮助 





已 移动 1 篇 文章 到 回收 站 。 撤销 














全 部 已 发 布 回收 站 搜索 页 面 
批量 操作 。 Y ”应 用 全 部 日 期 ”” 闻 选 2 项 目 
标题 作者 EE 日 期 
上 嘿 评论 Sample Page admin 一 2015-10- 
已 发 布 
分 外 观 
关于 易 百 教程 admin ”一 12 分 钟 前 
族 ” 插件 已 发 布 
2& 用户 
a 标题 作者 。 音 日 期 
开具 
批量 操作 ” ”应 用 2 项 目 





设置 





Wordpress 添 加 标签 - Wordpress 教 程 


标签 附加 用 于 识别 主要 内 容 或 文章 信息 的 目的 。 它 告诉 访问 者 实际 的 文章 是 什么 。 如 果 所 提 


到 的 标签 正确 ， 那 么 它 有 助 于 找到 内 容 。 
按照 以 下 步骤 在 WordPress 中 添加 标签 。 


第 1 步 : 在 WordPress 点 击 文章 -> 标签 。 


添加 新 标签 批量 操作 ”应 用 
名 称 名 称 图 像 描述 别名 
标签 1 未 找到 标签 
这 将 是 它 在 站 点 上 显示 的 名 字 。 

名 称 图 像 描述 别名 
别名 批量 操作 ”应 用 
tag1 


别名 "是 在 URL 中 使 用 的 别称 ， 它 可 以 令 URL 更 “标签 可 以 有 选择 性 地 转换 成 分 类 目录 ， 请 使 用 标签 到 分 类 目录 转换 器 。 





美观 。 通 常 使 用 小 写 ， 只 能 包含 字母 ， 数 字 和 连 


字符 (-)。 


图 像 指 述 
这 是 一 个 标签 显示 

















以 下 是 标签 字段 的 详细 信息 。 


。 名 字 : 输入 标签 的 名 称 。 

。 别名 : 它 被 指定 在 标签 URL。 

。 描述 : 添加 您 的 标签 的 简要 说 明 。 当 在 标签 上 莽 停 它 就 会 显示 出 来 。 
填写 所 有 关于 标签 的 信息 之 后 ， 点 击 添加 新 标签 按钮 。 
第 2 步 : 接 下 来 ， 如 下 图 所 示 ， 新 创建 的 标签 将 得 到 显示 在 页 面 右 侧 。 


TutorialsPoint 后 端 教程 


添加 新 标签 批量 操作 "应 用 
名 口 名 称 图 像 描述 别名 总 数 
标签 1 这 是 一 个 标签 显示 tagl 0 











这 将 是 它 在 站 点 上 显示 的 名 字 。 


别名 





LL] 名 称 图 像 描述 别名 总 数 
“别名 "是 在 URL 中 使 用 的 别称 ， 它 可 以 令 URL 更 批量 操作 ” | 应 用 

美观 。 通 常 使 用 小 写 ， 只 能 包含 字母 ， 数 字 和 连 

字符 (-) 。 标签 可 以 有 选择 性 地 转换 成 分 类 目录 ， 请 使 用 标签 到 分 类 目录 转换 器 。 


图 你 指 述 


描述 只 会 在 一 部 分 主题 中 显示 。 





Wordpress 添 加 标签 - Wordpress 教 程 235 


> 一 从 口 
Wordpress 编 辑 标签 - Wordpress 教 程 
在 本 章 中 ， 我 们 将 学 习 在 WordPress 如 何 编辑 标签 。 可 以 学 习 如 何 添加 标签 在 WordPress 添 加 
标签 章节 。 以 下 是 简单 的 步 又 来 在 WordPress 中 编辑 标签 。 


第 1 步 : 在 WordPress 点 击 文章 -> 标签 。 


第 2 步 : 接 下 来 ， 你 可 以 看 到 tag1 (tag1 是 在 WordPress 添 加 标签 章节 中 创建 ) 。 当 光标 是 停 
在 标签 ， 有 几 个 选项 会 显示 在 标签 名 称 的 下 方 。 编 辑 标签 有 两 种 方式 ， 即 编辑 和 快速 编辑 


。 编辑 : 如 下 图 所 示 ， 点 击 的 标签 部 分 中 的 编辑 选项 。 














搜索 标签 
批量 操作 Y ”应 用 
名 称 图 像 描 述 别名 总 数 
标签 1 这 是 一 个 标签 显示 tag1 0 
[过 可 ] 束 编辑 是 除 ， 查 看 
名 称 图 像 描述 别名 总 数 
批量 操作 Y ， 应 用 
标签 可 以 有 选择 性 地 转换 成 分 类 目录 ， 请 使 用 标签 到 分 类 目录 转换 器 。 
您 可 以 编辑 任何 必 填 字段 ， 然 后 点 击 更 新 按钮 ， 如 图 下 面 的 屏幕 。 
显示 靶 贡 
编辑 标签 
名 称 标签 1 
这 将 是 它 在 站 点 上 显示 的 名 字 。 
别名 tag1 
"别名 "是 在 URL 中 使 用 的 别称 ， 它 可 以 令 URL 更 美观 。 通 常 使 用 小 写 ， 只 能 包 合 字 母 ， 
数字 和 连 字符 《〈-) 。 
图 像 描述 这 是 一 个 标签 显示 


描述 只 会 在 一 部 分 主题 中 显示 。 


TutorialsPoint 后 端 教程 


在 这 里 ， 标 签字 段 是 和 WordPress 添 加 标 签 签 章节 是 一 样 的 。 


广 
。 快速 编辑 : 如 下 图 所 示 ， 点 击 的 标签 部 分 快速 编辑 选项 。 


批量 操作 " ”应 用 


名 称 图 像 描述 别名 
标签 这 是 一 个 标签 显示 tag1 
aii | RES jos 

名 称 图 像 描 述 别名 


批量 操作 ” ”应 用 


标签 可 以 有 选择 性 地 转换 成 分 类 目录 ， 请 使 用 标签 到 分 类 目录 转换 器 。 


在 这 里 ， 你 只 能 编辑 如 下 图 所 示 标 签 的 名 称 和 别名 ， 然 后 点 击 更 新 标签 按钮 。 


批量 操作 ”应 用 


名 称 图 像 描述 别名 
快速 编辑 
名 称 标签 1 
别名 tag1 
取消 
名 称 图 像 描述 别名 


批量 操作 ” ， 应 用 


Wordpress 编 辑 标签 - Wordpress 教 程 
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Wordpress 删 除 标 签 - Wordpress 教 程 


在 本 章 中 ， 我 们 将 学 习 如 何在 WordPress 中 删除 标签 。 


可 以 学 习 如 何 添加 标签 在 WordPress 添 加 标签 章节 。 以 下 是 简单 的 步骤 来 在 WordPress 中 删 
除 标签 。 


第 1 步 : 在 WordPress 点 击 文章 -> 标签 。 


第 2 步 : 接 下 来 ， 你 可 以 看 到 tag1 (tag1 是 在 WordPress 添 加 标签 章节 中 创建 ) 。 当 光标 是 停 
在 标签 ， 有 几 个 选项 会 显示 在 标签 名 称 的 下 方 。 Click on 点 击 删除 标签 部 分 ， 如 下 图 所 示 。 


搜索 标签 
批量 操作 ” ， 应 用 1 项 目 
名 称 图 像 描述 别名 总 数 
标签 1 这 是 一 个 标签 显示 tag1 0 
编辑 快速 编辑 | 叫 除 | 查看 
名 称 图 像 描述 别名 总 数 
批量 操作 Y ， 应 用 1 项 目 
标签 可 以 有 选择 性 地 转换 成 分 类 目录 ， 请 使 用 标签 到 分 类 目录 转换 器 。 
当 你 点 击 删除 ， 会 得 到 一 个 弹出 消息 ， 要 求 您 确认 删除 ， 如 下 图 所 示 。 
显示 选项 帮助 
127.0.0.1 上 的 网 页 显示 : 
您 本 订 久 删除 所 选项 目 。 db 
- 点 击 “取消 停止 ， 点 去 “确定 ”删除 。 
批量 操作 1 项 目 
名 称 确定 取消 名 总 数 
标签 1 这 基 二 店 标签 昱 示 T381 0 
编辑 快速 编辑 查看 
名 称 图 像 描述 别名 总 数 
批量 操作 ” ”应 用 1 项 目 


标签 可 以 有 选择 性 地 转换 成 分 类 目录 ， 请 使 用 标签 到 分 类 目录 转换 器 。 


您 可 以 点 击 确定 按钮 ， 并 永久 删除 标签 。 


WordPress 添 加 链接 - Wordpress 教 程 

在 本 章 中 ， 我 们 将 学 习 如 何在 WordPress 的 页 面 添加 链接 。 链 接 是 从 一 个 资源 到 另 一 个 的 连 
接 。 添 加 链接 到 网 页 或 博客 帖子 可 以 帮助 您 连接 至 其 他 页 面 。 

以 下 是 简单 的 步骤 来 在 WordPress 中 添加 链接 。 

第 1 步 : 在 WordPress 中 点 击 页 面 -> 所 有 页 面 ， 如 下 图 所 示 。 


第 2 步 : 接 下 来 ， 将 得 到 显示 在 WordPress 中 创建 的 页 面 列表 ， 如 下 图 所 示 。 选 择 任 一 
以 在 它 里 面 添 加 链接 。 在 这 里 ， 我 们 要 在 关于 易 百 教程 页 面 添加 链接 。 





显示 选项 帮助 
页 面 ”新建 页 面 
全 部 已 发 布 | 回收 站 搜索 页 面 
批量 操作 。 vw ”应 用 全 部 日 期 ”” 洱 选 2 项 目 
标题 作者 。 音 日 其 
Sample Page admin 一 2015-10- 
0 
已 发 布 
关于 另 白 教程 admin 一 11 小 时 前 
已 发 布 
标题 作者 。 音 日 其 
批量 操作 。 ”应 用 2 项 目 


第 3 步 : 接 下 来 ， 选 择 任何 句子 或 单词 ， 你 想 添加 就 可 以 了 链接 。 在 这 里 ， 我 们 将 添加 链接 到 


编辑 页 面 “ 认 建 丙 

关于 易 百 教程 

固定 链接 : http:/127.0.0.1/about yiibai/， 编辑 查看 页 面 
个] 添加 媒体 


可 视 化 文本 
B I we| 三 | 三 6 -三 


hl 
册 
Be 
| 
明 


.| 时 冰 得 来 因特网 上 最 大 的 IT 技 术 入 门 学 习 实 例 教程 和 实例 资源 网 站 
。 易 百 教程 是 完全 免费 的 

。 易 百 教程 是 非 副 利 性 的 

。 易 百 教程 一 直 在 升级 和 更 新 


第 4 步 : 接 下 来 ， 当 你 点 击 插入 /编辑 链接 符号 然后 弹出 如 下 窗口 (显示 出 来 )。 
插入 或 编辑 链接 x 
输入 目标 URL 
URL 


链接 文本 “ 易 自 教程 
在 新 窗口 或 标签 页 打开 链接 


或 链接 到 站 点 中 的 内 容 Y 


下 面 是 插入 /编辑 链接 的 字段 。 





。 URL: 输入 你 要 链接 的 网 址 (目标 网 址 )。 
。 链接 文本 : 将 要 进入 链接 文本 。 
。 在 新 窗口 或 标签 页 打开 链接 : 它 会 打开 网 页 链接 到 新 的 标签 或 窗口 ， 根 据 需要 勾 选 。 


。 或 链接 到 站 点 中 的 内 容 : 它 通过 从 给 定 的 列表 中 选择 的 页 面 链 接 到 现 有 的 内 容 页。 点 击 或 
链接 到 站 点 中 的 内 容 ， 网 页 和 帖子 列表 获取 显示 如 下 图 所 示 。 


TutorialsPoint 后 端 教程 





插入 或 编辑 链接 


输入 目标 URL 


URL 


链接 文本 ”多 白 教 程 
在 新 窗口 或 标签 页 打开 链接 


或 链接 到 站 点 中 的 内 容 a 


搜索 


| 未 指定 搜索 条 件 。 自动 显 示 近期 条 目 。 


关于 易 百 教程 


文章 标题 - 关于 易 百 教程 


Sample Page 


Hello world! 


取消 


接 。 


2015-10-20 





从 列表 中 选择 特定 页 面 或 文章 后 ， 则 该 链接 的 URL 字 段 创建 如 上 图 所 示 。 点 击 添加 链 


第 5 步 : 接着 ， 如 果 对 这 些 字 悬 停 易 百 教程 那么 链 路 提示 获得 显示 如 下 所 示 。 


编辑 页 面 ” 弛 时 页 
关于 易 百 教程 


固定 链接 : http://127.0.0.1/about_yiibai/ 
据 ] 添加 媒体 
B Te 人 | 三 三 6% -三 


编辑 ” 查看 页 面 


山 
必 h 
| 
站 
1 
上 





易 百 沿 程 是 因特网 上 最 大 的 IT 技 术 入 门 学 习 实 例 教程 和 实例 资源 网 站 





页 百 弧 伍 定 下 三 7TTTEHT 


. 
- yiibai.com/html/about/about us 2 X 
本 
. 


易 百 教程 一 直 在 升级 和 更 新 


接 下 来 ， 点 击 更 新 按钮 来 更 新 改变 你 的 页 面 或 文章 。 
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可 视 化 


文本 


四 
Ca 


发 布 “^ 


9 状态 : 已 发 布 编 辑 
人 @ 公开 度 : 公开 编辑 


曾 发 布 于 : 2015 年 10 月 24 日 @ 14:04 编辑 


移 至 回收 站 EE 


页 面 属性 “^ 
父 级 

(无 父 级 ) ” 
排序 


242 
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在 本 章 中 ， 我 们 将 研究 如 何在 WordPress 中 编辑 链接 。 你 可 以 在 WordPress 添 加 链接 这 一 章节 
中 学 习 如 何 添 加 链接 。 

以 下 是 简单 的 步骤 来 在 WordPress 编 辑 链接 


第 1 步 : 点 击 页 面 -> 所 有 页 面 ， 如 下 图 所 示 。 


第 2 步 : 接 下 来 ， 您 可 以 查看 页 面 列表 。 当 光标 悬 停 在 关于 易 百 教程 页 面 上 ， 几 个 选项 被 显 
示 在 关于 易 百 教程 的 下 面 。 点 击 编辑 ， 如 图 所 示 。 


SEE 显示 选项 帮助 
页 面 “者 奸 页面 
全 部 已 发 布 | 回收 站 搜索 页 面 
批量 操作 v 应 用 全 部 日 期 ”” 闻 选 2 项 目 
标题 作者 站 日 其 
Sample Page admin EE 2015-10- 
已 发 
关于 易 百 教程 一 i 
[大 村 | 这 六 和 垃圾 箱 ”查看 已 发 布 
标题 作者 。 站 日期 
批量 操作 ”应 用 2 项 目 





第 3 步 : 接 下 来 ， 将 鼠标 悬 停 在 关于 易 百 教程 (在 WordPress 创 建 链接 这 一 章节 中 创建 ) ， 
并 单 击 铅笔 符号 来 编辑 链接 ， 如 下 图 所 示 。 
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关于 易 百 教程 发 布 
固定 链接 : http://127.0.0.1/about yiibai/， 编 辑 ， 查看 页 面 预览 更 改 
态 : 市 
器 ] 添加 媒体 右 视 化 |Ee 9 状态 : 已 发 布 编辑 
- - -a ee 人 @@ 公开 度 : 公开 编辑 
B Te|EIE6 人 6 一 三 三 三 |[ 罗 党 三 并 
和 版 本 : 2 查阅 


曾 发 布 于 : 2015 年 10 月 24 日 @ 14:04 编辑 
。 易 百 散 程 是 因特网 上 最 大 的 IT 技 术 入 门 学 习 实例 教程 





3 总 称 至 回收 站 更 新 
mm 发 Z 站 | 
. 至 起 元 
。 易 百 教程 是 非 盈利 性 的 页 面 属性 a 
。 易 百 教程 一 直 在 升级 和 更 新 Ey 
(无 父 级 ) Y 
排序 


0 


第 4 步 : 接 下 来 ， 您 可 以 从 现 有 列表 中 选择 页 面 中 更 改 或 修改 链接 。 这 里 我 们 选择 关于 易 百 教 
程 页 面 。 

插入 或 编辑 链接 x 
输入 目标 URL 


URL http://www.yiibai.com/html/about/about_us.htm 


链接 文本 易 白 教程 
V| 在 新 窗口 或 标签 页 打开 链接 


或 链接 到 站 点 中 的 内 容 a 
搜索 


| 未 指定 扫 索 条 件 。 自 动 时 示 近 期 条 目 。 





关于 易 百 教 程 页 面 
文章 标题 - 关于 易 百 教程 2015-10-23 
Sample Page 页 面 
Hello world! 2015-10-20 
取消 和 更 新 


从 列表 中 选择 特定 的 页 面 或 文章 后 ， 然 后 点 击 更 新 按钮 。 
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第 5 步 : 接着 ， 如 果 对 易 百 教程 其 停 那么 链接 提示 如 下 所 示 。 


关于 易 百 教程 发 布 
固定 链接 : http://127.0.0.1/about yiibai/ 编辑 ， 查 看 页 面 预览 更 改 
态 : 而 
日] 添加 媒体 = 国生 
a， a 、， ”> 公开 度 : 公开 编辑 
B Te 人 | 三 | 三 6 一 三 三 三 |O 澡 三 式 
人 版 本 : 2 查阅 


曾 发 布 于 : 2015 年 10 月 24 日 @ 14:04 编辑 








。 易 百 教程 是 非 僵 利 性 的 页 面 属性 
。 易 百 教程 一 直 在 升级 和 更 新 必 级 

(无 父 级 ) 

排序 

0 


接 下 来 ， 点 击 更 新 按钮 来 更 新 改变 你 的 页 面 或 文章 。 
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在 本 章 中 ， 我 们 将 学 习 如 何在 WordPress 中 删除 链接 。 你 可 以 在 WordPress 添 加 链接 这 一 章节 
中 学 习 如 何 添 加 链接 。 

以 下 是 简单 的 步骤 来 在 WordPress 删 除 链接 


第 1 步 : 点 击 页 面 -> 所 有 页 面 ， 如 下 图 所 示 。 


第 2 步 : 接 下 来 ， 可 以 查看 页 面 列表 。 当 光标 悬 停 在 关于 易 百 教程 页 面 上 ， 几 个 选项 显示 关 
于 易 百 教程 的 名 称 下 面 。 点 击 编辑 ， 如 图 所 示 。 


显示 选项 者 县 
页 面 ”新建 页 面 
全 部 已 发 布 | 回收 站 搜索 页 面 
批量 操作 ”应 用 ”全 部 日 期 ” 和 萍 先 2 项 目 
标题 作者 。 音 日 其 
Sample Page admin 一 2015-10- 
20 
已 发 布 
关于 易 白 教程 admin as 12 中 ,时 前 | 
[要] 快 速 编辑 垃圾 箱 ”查看 已 家 7 
标题 作者 。 音 日 其 
批量 操作 。 ” ”应 用 2 项 目 


第 3 步 : 接 下 来 ， 选 择 您 已 经 添加 链接 的 话 ， 即 易 百 教程 (链接 易 百 教程 是 WordPress 添 加 
链接 中 创建 的 ) ， 然 后 点 击 删除 链接 代码 ， 如 下 图 所 示 。 


TutorialsPoint 后 端 教程 


显示 选项 Y 帮助 Y 


编辑 页 面 ”新建 页 夯 
关于 易 百 教程 发 布 
固定 链接 : http://127.0.0.1/ 关 于 易 百 教程 ， 编辑 ” 查看 页 面 预览 更 改 
获取 短 链 接地 址 
?9 状态 : 已 发 布 编辑 
外 ] 添加 媒体 可 视 化 文本。 。 @ 公 开 度 : 公开 编辑 
B Te[ 汪 三 6 一 王 三 三 | 罗 深 属 沁 。 信 版 本 :3 相国 
章 发 布 于 : 2015 年 10 月 24 日 @ 14:04 编辑 


易 百 教程 是 因特网 上 最 大 的 IT 技术 入 门 学 习 实例 教程 移 至 回收 站 


| iibai.com/html/about/about us 多 X | 











. 译 十 元 页 面 属性 ^ 
。 易 百 教程 是 非 僵 利 性 的 gi 
。 易 百 教程 一 直 在 升级 和 更 新 
(无 父 级 ) Y 
排序 


第 4 步 : 接着 ， 如 果 对 这 些 易 百 教程 县 停 ， 就 没有 现 有 工具 提示 URL。 


编辑 页 面 ”新 尘 页 面 
关于 易 百 教程 发 布 a 
固定 链接 : http://127.0.0.1/ 关 于 易 百 教程 / 编辑 ， 查看 页 面 预览 更 改 
获取 短 榜 接地 址 
9 状态 : 已 发 布 编辑 
向] 添加 媒体 可 视 化 ”文本 ”人 @ 公开 度 : 公开 编辑 
B I “|EjEG- 三 三 三 GO 小三 六 版 :3 直 国 
前 发 布 于 : 2015 年 10 月 24 日 @ 14:04 编辑 
。| 易 百 教程 是 因特网 上 最 大 的 IT 技术 入 门 学 习 实例 教程 Ts 
和 实例 资源 网 站 
。 易 百 教程 是 完全 免费 的 页 面 属性 加 
。 易 百 教程 是 非 僵 利 性 的 i 
。 易 百 教程 一 直 在 升级 和 更 新 
(无 父 级 ) * 
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在 本 章 中 ， 我 们 将 学 习 如 何在 WordPress 中 添加 评论 。 添 加 评论 可 以 让 你 的 访客 参与 评论 。 评 
论 由 管理 员 审 核发 布 以 进一步 讨论 。 

按照 以 下 步骤 料 评论 添加 到 您 的 博客 文章 。 


步骤 (1) : 在 WordPress 中 点 击 页 面 -> 所 有 页 面 。 


步骤 (2) : 在 WordPress 中 创建 的 页 面料 显示 列表 如 下 图 所 示 。 选 择 任何 你 想 要 添加 注释 的 页 
面 。 在 这 里 ， 我 们 要 添加 评论 到 关于 易 百 教程 页 面 。 点 击 关于 易 百 教 程 。 


显示 选项 帮助 
页 面 ” 新 硅 页 面 
全 部 已 发 布 | 回收 站 搜索 页 面 
批量 操作 ，* 应 用 ， 全 部 日 期 ”， 饰 选 2 项 目 
标题 作者 。 音 日 其 
Sample Page admin Ey 2015-10- 
发布 
关于 易 白 教程 admin 一 13 小 时 前 
[ 寅 要 | 内 谴 编辑 “垃圾 箱 ， 坦 看 已 发 布 
标题 作者 。 音 日 期 
批量 操作 。 ”应 用 i 





步骤 (3) : 接着 ， 添 加 评论 此 页 面 上 ， 点 击 出 现在 左上 方 的 角落 屏幕 的 选项 。 


: 下 个 这 人 帮助 
页 面 ” 新 建 页 面 
全 部 已 发 布 | 回收 站 搜索 页 面 
批量 操作 ”应 用 ”全 部 日 期  ， 谤 选 2 项 目 
标题 作者 。 音 日 其 
Sample Page adrnin 2 2015-10- 
已 发 布 
关于 易 白 教程 admin es 13 小 时 前 
已 发 布 
标题 作者 如 日 期 
批量 操作 。 ， 应 用 2 


步骤 (4) : 接 下 来 ， 获 取 显 示 的 屏幕 选项 的 下 拉 列 表 。 检 查 讨论 和 评论 ， 如 下 图 所 示 。 





TutorialsPoint 后 项 


显示 下 列 项 目 
修订 版 本 自 定义 栏目 | [YI 讨论 [WO 评论 别名 作者 ”|Y| 页 面 属性 ”|Y| 特色 图 片 
页 面 布 局 


分 栏 数目 : 1 (@) 2 
YW 启用 全 高 度 编 辑 器 和 免 打 扰 功 能 。 





显示 选项 

编辑 页 面 ” 新 娃 页 面 
| 有 一 个 自动 保存 的 版 本 比如 下 显示 的 版 本 还 要 新 。 
关于 易 百 教程 发 布 
固定 链接 : http://127.0.0.1/ 关 于 易 百 教程 /编辑 查看 页 面 预览 更 改 
获取 短 链 接地 址 

9 状态 : 已 发 布 编辑 
站 ] 添加 媒体 可 视 化 ”文本 人 @@ 公开 度 : 公开 编辑 
三 又 和 版 本 : 3 查阅 


步骤 (5) : 接 下 来 ， 可 以 在 页 面 的 底部 查看 讨论 和 评论 框 。 


讨论 4 


允许 评论 。 


这 个 页 面 接受 trackback 和 pingback。 





评论 : 


还 没有 评论 呢 。 


在 评论 部 分 ， 有 两 个 选项 存在 : 


。 人 允许 评论 : 让 游客 在 你 的 博客 文章 和 网 页 发 表 评 论 。 
。 这 个 页 面 接受 trackback 和 pingback。: 让 游客 给 ping 和 引用 通告 。 


在 评论 部 分 中 ， 您 可 以 通过 点 击 添加 评论 按钮 添加 评论 。 
步骤 (6) : 添加 评论 之 后 ， 点 击 更 新 按钮 。 


HoAl 
ZL4J 


\A/ArAdDracc 污 0 :也 :人 入 ER EE 
VVOFTQFTreSsSSWi 响 过 人伦 - VVOrQDres 





TutorialsPoint 后 端 教程 


讨论 a 
允许 评论 。 

这 个 页 面 接受 trackback 和 pingback。 

评论 区 
添加 新 评论 





| b || i || link | b-quote || det || ins || img || ul || ol || li || code | 
| 关闭 标签 | 





这 是 一 个 评论 测试 用 出 


一 一 
机 
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Wordpress 编 辑 评论 - Wordpress 教 程 


在 本 章 中 ， 我 们 将 学 习 如 何在 WordPress 中 编辑 评论 。 编 辑 评论 只 能 由 管理 员 来 完成 。 你 可 以 
学 习 如 何在 WordPress 添 加 评论 。 


按照 以 下 步骤 是 在 WordPress 中 编辑 评论 。 


步骤 (1) : 在 WordPress 中 点 击 评论 。 


步骤 〈2) 


编辑 。 


盟 评论 


怪 插件 
e@ 用 户 
| 
图 设置 








十 新 建 您 好 ,， admin 
帮助 
编辑 评论 
作者 状态 
名 称 : admin 查看 评论 
e) 已 审核 
电子 邮件 : yiibai.com@gmail.com 待 审 
垃圾 评论 
URL: 网 提交 于 : 2015 年 10 月 25 日 @ 02:59 编辑 
回应 给 : 关于 易 百 教程 
移 至 回收 站 更 新 
b nk b-quote det ns img ul 0 code 


关闭 标签 


这 是 一 个 评论 测试 用 例 





十 新 建 
显示 选项 
v2 
评论 
全 部 | 待 审 获准 | 垃圾 评论 回收 站 
批量 操作 Y || 应 用 全 部 评论 类 型 " 乌 选 
作者 评论 
成 admin 提交 于 2015-10-252:59 上 午 
yiibai.com@gmail.co 这 是 一 个 评论 测试 用 便 
m 驱 回 ”回复 ”快速 编辑 垃圾 评论 。” 移 至 回收 站 
127.0.0.1 
七 ”MrWordPress ”提交 于 2015-10-203:31 上 午 
https://wordpress.org Hi, this is a comment 
l To delete a comment, just log in and view the posts comments. There you 


作者 


批量 操作 v | 应 用 


will have the option to edit or delete them 


评论 


: 接 下 来 ， 你 可 以 查看 评论 列表 中 的 各 个 页 面 。 选 择 任何 评论 对 其 进行 编辑 。 点 击 


您 好 ，admin 网 


回复 至 


关于 易 百 教程 
查看 页 面 


Hello world! 


查看 文章 





步骤 〈3) : 接 下 来 ， 编 辑 注 释 页 面 得 到 展示 。 您 可 以 编辑 注释 ， 点 击 更 新 按钮 。 








月 23 文章 标题 - 关于 易 百 教程 
3 20 日 Hello world! 


























由 admin 发 表 在 攻关 于 易 百 教程 # 兴 
这 是 一 个 评论 测试 用 例 


在 这 里 ， 可 以 编辑 姓名 ， 电 子 邮 件 ，URL 或 评论 框 的 评论 内 容 。 
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在 本 章 中 ， 我 们 将 研究 如 何在 WordPress 中 查看 插件 。 它 可 以 帮助 你 启用 和 禁用 WordPress 插 
件 。 这 增加 了 网 站 独特 的 功能 。 插 件 扩展 和 扩大 WordPress 的 功能 。 


以 下 是 简单 的 步骤 来 在 在 WordPress 坦 看 插件 。 


步骤 (1) : 管理 员 在 WordPress 中 点 击 插件 -> 已 安装 的 插件 ， 如 下 图 所 示 。 





WE zt 


tl 仪表 盘 
首页 
更 新 要 区 
办 2 篇 文章 轿 2 个 页 面 
太 文章 盟 2 条 评论 


四] 多 媒体 











WordPress 4.3.1， 使 用 Twenty Fifteen 主 题 。 








活动 


文章 标题 - 关于 易 百 教程 


已 安装 的 插件 
Hello world! 


安装 插件 
编辑 


由 admin 发 表 在 攻关 于 易 百 教程 # 必 
这 是 一 个 评论 测试 用 全 


: 接 下 来 ， 会 看 到 您 网 站 上 的 现 有 插件 列表 ， 


步骤 (2) 








您 好 ， admin 匡 









显示 选项 帮助 








在 想 些 什么 ? 


草稿 

这 是 一 个 测试 交 章 标题 十 月 24, 2015 
下 面 是 关于 易 百 教 程 .， 
WordPress 新 闻 


八 月 20, 2015 
dPress 4.3 漳 体 中 文 版 现 已 开放 下 载 。 


WordPress 4.3"Billie” 





如 下 图 所 示 : 


dm | 
插件 ”安装 插件 


WP Super Cache 已 禁用 。 请 去 插件 管理 首页 开启 细 存 功能 。 





全 部 启用 | 未 启用 搜索 已 安装 插件 
批量 操作 ， | 应 用 
ea 插件 图 信 描 术 
人 党 外 观 bly the best way in the world to protect your blog from spam. It 
外 插件 启用” 饥 辑 肌 除 


sleep, To get started: 1) Click the "Activate" link to the left of 





configuration page, and save your API key. 
已 安装 的 插件 
安装 插件 3.1.5 版 本 | 由 Automattic 创 建 | 查看 详情 


编辑 WP Super Cache |Very fast caching plugin for WordPress 


用 户 保 下 ”人 惕 用 


润 福 。 “1.4.6 版 本 | 由 Automattic 创 建 | 查看 详情 


WP Super Cache must be configured. Go to the admin page to enable and configure the plugin. 


这 不 是 普通 的 插件 ， 它 象征 着 一 代 作 希望 和 热情 ,浓缩 成 Louis Armstrong 的 四 个 字 : 你 好 ， 多 莉 。 在 启用 
启用 ”编辑 晤 除 


后 ， 在 您 站 点 后 台 每 个 页 面 的 右上 角 都 可 以 看 到 一 句 来 自尽 悄 红 娘 少 音乐 居 的 英文 原版 台词 
1.6 版 本 | 由 Matt Mullenweg 创 建 | 查看 详情 





这 里 ， 将 显示 用 插件 和 描述 的 表格 。 该 插件 的 名 称 在 插件 栏 定义 ， 对 插件 的 简要 说 明 根 据 描 
述 列 来 定义 。 


工具 栏 : 
以 下 是 在 插件 工具 栏 的 选项 : 

。 启用 * : * 显 示 了 网 站 上 的 活动 (启用 ) 插件 。 

。 未 启用 : 显示 已 安装 的 插件 ， 但 处 于 非 活动 (未 启用 ) 状态 的 网 站 上 。 
。 更 新 可 用 : 显示 如 果 有 新 版 本 可 用 ， 或 者 要 求 立即 更 新 。 


| | By 
Wordpress 安 委 插 件 - Wordpress 教 程 
在 本 章 中 ， 我 们 将 学 习 如 何在 WordPress 安 装 插件 。 在 WordPress 安 装 插件 这 是 很 容易 的 。 
所 有 的 插件 都 可 以 免费 下 载 ;唯一 的 选择 是 一 个 插件 必须 在 WordPress 的 目录 中 。 
以 下 是 在 WordPress 安 装 插件 的 简单 的 步骤 。 


步骤 (1) : 在 WordPress 中 点 击 插件 -> 安装 插件 。 


步骤 〈《2) : 接 下 来 ， 在 搜索 框 中 输入 你 需要 的 插件 名 称 。 插 件 这 是 相关 的 插件 名 称 列表 将 得 
到 显示 ， 如 图 所 示 。 























WE zt 十 新 建 您 好 ， admin 
帮助 
名 仪表 盘 添加 插件 上 对 项 
准 文章 
所 ] 多 媒体 
加 页 面 142 项 第 1 页 共 5 页 
评论 
Allin One SEO Pack All Meta Stats All in One 


外 观 


SEO Pack Addon 





怪 插件 


All in One SEO Pack isa 
Wi EO plugin to 





已 安装 的 插件 
安装 插件 


can see the sta 






All in On 


BNetAttingo Technologies 人 人 @ 











食 丛 人 广 食 食 (1) 最 近 更 新 : 1 月 前 
三 三 人 广 信 让 (225) 最 近 更 新 : 2 月 前 ee F 
200+ 活 跃 安装 未 在 您 的 Wordpress 版 本 中 测 
100 万 + 活跃 安装 V 该 插件 兼容 于 您 当前 使 用 的 试 
Wordpress 版 本 。 


选择 您 想 要 使 用 的 插件 。 在 这 里 ， 我 们 搜索 : All in one SEO Pack 插件 , 这 恰好 是 所 述 的 第 一 
个 插件 在 屏幕 上 面 显 示 。 点 击 立即 安装 按钮 ， 在 您 的 网 站 上 安装 插件 。 


步骤 (3) : 接 下 来 ， 插 件 开始 下 载 并 安装 该 插件 。 


正在 安装 插件 : All in One SEO Pack 2.2.7.2 

正在 从 https://downloads .wordpress.org/plugin/all-in-one-seo-pack.zip 下 载 安 装 包 ... 
正在 解压 缩 安装 包 .… 

正在 安装 插件 … 


安装 插件 All in One SEO Pack 2.2.7.2 成 功 。 





名 插件 
已 安装 的 插件 
安装 插件 
编辑 

吉 用 户 
pp 工具 
设置 





点 击 启动 插件 激活 插件 在 您 的 网 站 中 ， 使 用 这 个 插件 使 您 的 工作 更 加 容易 。 
步骤 〈4) : 接 下 来 ， 您 将 看 到 已 安装 插件 的 插件 列表 ， 如 下 图 所 示 。 


十 新 建 您 好 ，admin 


显示 选项 帮助 


插件 支线 插件 


WP Super Cache 已 禁用 。 请 去 插件 管理 首页 开启 备 存 功能 。 


























全 部 启用 | 未 启用 搜索 已 安装 插件 
批量 操作 ” ， 应 用 4 项 目 
插件 图 像 描述 
Akismet Used by millions, Akismet is quite possibly the best way in the world to protect your blog from 
启用 ”编辑 有 旺 除 spam. lt keeps your site protected even while you sleep. To get started: 1) Click the "Activate" link to 





the left of this description, 2) Sign up for an Akismet plan to get an API key, and 3) Go to your 
已 安装 的 插件 Akismet configuration page, and save your APl key 


安装 插件 3.1.5 版 本 | 由 Automattic 创 建 | 查看 详情 


编辑 
All In One SEO Pack ut-of-the-box SEO for your \ 
-用 户 启用 编辑 风 除 Donate ort | Ama 


2.2.7.2 版 本 | 由 Micha ert 创 建 | 查看 详情 








ress blog. Options configuration panel | Upgrade to Pro Version 












WP Super Cache Very fast caching plugin for WordpPress 
设置 停 用 编辑 1.4.6 版 本 | 由 Automattic 创 建 | 查看 详情 


WP Super Cache must be configured. Go to the admin page to enable and configure the plugin. 





WordPress 目 定义 插件 - Wordpress 教 程 


在 本 章 中 ， 我 们 将 学 习 如 何在 WordPress 中 自 定义 插件 。 它 通常 是 多 用 户 的 网 站 。 在 这 里 ， 
我 们 了 解 学 习 如 何在 无 需 编 写 任 何 HTML 或 CSS 自 定义 WordPress 插 件 。 这 种 新 的 方法 可 以 
让 你 使 用 WordPress 主 题 定制 ( 无 需 编码 技能 ) 来 定制 你 的 登录 页 面 。 


以 下 是 简单 的 步骤 ， 在 WordPress 自 定义 插件 。 


步骤 (1) : 在 WordPress 中 点 击 插件 -> 安装 插件 。 


步骤 (2) : 安装 并 激活 自 定义 登录 页 面 自 定义 插件 (Custom Login Page Customizer) 。 


国人 台 易 百 教程 十 新 奸 








您 好 ， admin 
ee 帮助 
a 添加 插件 上 伟 才 人 
玉 文章 
a 搜索 结果 ”特色 ”热门 ”推荐 ”收藏 关键 词 * Custom Login Page Customizer 
1,522 项 目 第 1 | 页 , 共 51 页 |》 » 
同 Custom Login Page lp Custom Admin Login 
Customizer Page | WPZest 


现在 安装 更 多 详情 


已 安装 的 插件 
安装 插件 
编辑 


Create beautiful Custom Admin 







Login. Es 


er can U 





required. Us s 
custom style in their log 
with Google reCapt 




















. 户 BHardeep Asromi 弄 全 
oe 用 而 WPpzest 到 名 
人 工具 
全食 贪 食 页 (21) 最 近 更 新 : 1 月 前 
设置 50,000+ 活 跃 安装 v 该 插件 兼容 于 您 当前 使 用 的 友 碍 太太 食 () 最 近 更 新 2 天 前 
@@ 收 起 荣 音 WordPress 版 本 。 20+ 活 路 安装 Y 该 插件 兼容 于 您 当前 使 用 的 





WordPress 版 本 。 


步骤 (3) : 接 下 来 ， 在 WordPress 点 击 外 观 -> Login Customizer( 登 录 定制 )。 


您 好 ，admin 












快速 草稿 


办 2 篇 文章 硬 2 个 页 面 
肯 2 条 评论 


标题 


在 想 些 什么 ? 
Wordpress 4.3.1， 使 用 Twenty Fifteen 主 题 。 


文章 标题 - 关于 易 百 教程 草稿 


Hello world! 这 是 一 个 测试 文章 标题 十 月 24, 2015 
下 面 是 关于 易 百 教程 .. 


全 全 WordPress 新 闻 
-1 有 


WordPress 4.3“Billie” 八 月 20, 2015 


ordPress 4.3 漳 体 中 文 版 现 已 开放 下 载 。 
Press 发 表 在 发 Hello world! 大 





NN 
涝 
dl 
ly 
装 


步骤 (4) : 点 击 开 始 按钮 ， 进 一 
十 新 建 您 好 , admin 国 


Login Customizer 






Howdy! 


Start Customizing! 


Credits/Support (All the unwanted crap) 


If you find any issues or if you want to contribute, then please free to drop me a mail at this link. 





Thanks for using this plugin. Don not forget to leave a review 


Themelsle :) 


背景 


Login Custormizer 





步骤 〈5) : 接 下 来 ， 它 将 启动 内 置 WordPress 主题 定制 。 可 以 自 定 义 你 想 要 的 主题 方式 。 





TutorialsPoint 后 端 教程 


x ES 


























您 正在 自 定义 【?) 
易 百 教程 
激活 主题 
Twenty Fifteen 更 改 _ 
用 户 名 
站 点 身份 > admin 
颜色 > 
顶部 图 像 > 记 住 我 的 登录 信息 
背景 图 像 > 
芋 > 忘记 密码 ? 
静态 首页 > 回 到 易 百 教程 


在 这 里 ， 点 击 侧面 板 中 的 新 Login Customizer 选项 卡 上 。 登 录 定 制 页 面 将 得 到 显示 。 在 登录 
定制 页 面 ， 可 以 用 同样 的 方式 来 定制 你 的 登录 页 面 ， 可 以 自 定义 WordPress 的 主题 。 


步骤 〈6) : 接 下 来 ， 您 将 看 到 自 定义 登录 页 面 ， 作 为 一 个 演示 示例 ， 这 里 只 是 修改 了 登陆 的 
Logo， 如 下 图 所 示 。 
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TutorialsPoint 后 端 教程 





x ES 


您 正在 自 定义 (2 
Login Customizer 


Background > 用 户 名 
Form Background > admin 
Form Styling > 泌 码 
Fields Styling > 

记 住 我 的 登录 信息 
Button Styling > 
Other > 


< 





e。 标志 : 选择 上 传 标志 来 替换 默认 WordPress 标 志 。 


先 
。 背景 : 添加 背景 图 片 ， 或 者 您 可 以 选择 您 所 选择 的 





回 


到 | 


n 














教程 


起 里 
月 时 


。 表格 背景 : 选择 表单 背景 图 片 或 颜色 选择 登录 表单 容器 。 


大 多 数 选择 在 定制 面板 是 透明 的 。 可 以 检查 出 所 有 按 您 要 求 选 择 的 定制 调整 设置 


击 保存 并 发 布 按钮 。 
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Wordpress 用 户 角色 - Wordpress 教 程 


在 本 
用 。 


这 里 


章 中 ， 我 们 将 了 解 在 WordPress 的 用 户 角 色 。 在 WordPress 的 每 个 用 户 都 有 自己 的 作 
角色 就 是 给 一 个 特定 用 户 访问 WordPress 站 点 权限 。 这 些 角 色 只 能 由 管理 员 进 行 分 配 。 


一 些 在 WordPress 中 使 用 的 几 个 角色 : 


ZE 

管理 员 : 管 理 员 拥有 所 有 的 权限 。 管 理 员 在 WordPress 的 网 站 可 以 做 任何 事情 ， 他 可 以 创 
建 更 多 管理 员 ， 和 邀请 更 多 的 用 户 ， 也 可 以 删除 它们 。 

编辑 *:* 编 辑 可 以 访问 所 有 文章 ， 页 面 ， 评 论 ， 分 类 ， 标 签 和 链接 。 他 们 可 以 创建 ， 发 
布 ， 编 辑 或 删除 任 文章 位 或 网 页 。 

作者 :作者 只 能 写 文章 或 帖子 ， 上 传 照片 ， 编 辑 和 发 布 自己 的 文章 帖子 。 

贡献 者 *: * 投 稿 者 只 能 编 宇和 编辑 自己 的 文章 帖子 直到 被 发 布 。 他 们 可 以 创建 自己 的 文 
章 和 页 面 ， 但 不 能 发 布 。 他 们 无 法 上 传 图 片 或 文件 ， 但 可 以 看 到 网 站 的 状态 。 当 他 们 想 
要 发 布 的 任何 文章 或 帖子 ， 必 须 先 亲自 通知 管理 员 的 撰 稿 人 审查 。 当 获得 批准 后 投稿 人 
可 以 不 进行 任何 更 改 发 表 文章 。 

订阅 者 : 跟随 只 能 读 取 ， 并 在 帖子 发 表 评 论 。 关 注 者 可 登录 到 帐户 接收 更 新 的 内 容 。 
查看 者 : 查看 者 只 能 查看 自己 的 帖子 ;他 们 不 能 修改 ， 但 只 能 在 帖子 发 表 评 论 。 


Yii2 教 程 
Yii 是 什么 


===========Yii 是 一 个 高 性 能 ， 基 于 组 件 的 PHP 框架 ， 用 于 快速 开发 现代 Web 应 用 程 
序 。 名 字 Yii ( 读 作 易 ) 在 中 文 里 有 “极致 简单 与 不 断 演变 ” 两 重 含 义 ， 也 可 看 作 Yes lt lsl! 
的 缩写 。 


Yii 最 适合 做 什么 ? 


Yii 是 一 个 通用 的 Web 编程 框架 ， 即 可 以 用 于 开发 各 种 基于 PHP 的 Web 应 用 。 因 为 基于 组 
件 的 框架 结构 和 设计 精巧 的 缓存 支持 ，Yii 特别 适合 开发 大 型 应 用 ， 如 门户 网 站 、 论 坛 、 内 容 
管理 系统 (CMS) 、 电 子 商 务 项 目 和 RESTful Web 服务 等 。 


Yii 和 其 他 框架 相 比 呢 ? 


。 和 其 他 PHP 框架 类 似 ，Yii 实现 了 MVC (Model-View-Controller) 设计 模式 并 基于 该 模 
式 组 织 代 码 。- Yii 的 代码 简洁 优雅 ， 这 是 Yii 的 编程 哲学 。 它 永远 不 会 为 了 要 迎合 某 个 设 
计 模 式 而 对 代码 进行 过 度 的 设计 。- Yii 是 一 个 全 栈 框架 ， 提 供 了 大 量 久 经 考验 ， 开 箱 即 
用 的 特性 ， 例 如 : 对 关系 型 和 NoSQL 数据 库 都 提供 了 查询 生成 器 (QueryBuilders) 和 
ActiveRecord ; RESTful API 的 开发 支持 ; 多 层 缓存 支持 ， 等 等 。- Yii 非常 易于 扩展 。 你 
可 以 自 定义 或 替换 几乎 任何 一 处 核心 代码 。 你 还 会 受益 于 它 坚 实 可 靠 的 扩展 架构 ， 使 
用 、 再 开发 或 再 发 布 扩展 。- 高 性 能 始终 是 Yii 的 首要 目标 之 一 。Yii 不 是 一 场 独 角 戏 ， 它 
由 一 个 强大 的 开发 者 团队 提供 支持 ， 也 有 一 个 庞大 的 专家 社区 ， 持 续 不 断 地 对 Yii 的 开发 
作出 贡献 。Yii 开发 者 团队 始终 对 Web 开发 最 新 潮流 和 其 他 框架 及 项 目 中 的 最 佳 实践 和 
特性 保持 密切 关注 ， 那 些 有 意义 的 最 佳 实践 及 特性 会 被 不 定期 的 整合 进 核心 框架 中 ， 并 
提供 简单 优雅 的 接口 。 


Yii 版 本 
Yii 当前 有 两 个 主要 版 本 : 1.1 和 2.0。 1.1 版 是 上 代 的 老 版 本 ， 现 在 处 于 维护 状态 。2.0 版 是 
一 个 完全 重 写 的 版 本 ， 采 用 了 最 新 的 技术 和 协议 ， 包 括 依 赖 包 管 理 器 (Composer) 、PHP 代 


码 规范 (PSR) 、 命 名 空间 、Traits (特质 ) 等 等 。 2.0 版 代表 了 最 新 一 代 框 架 ， 是 未 来 几 年 
中 我 们 的 主要 开发 版 本 。 本 指南 主要 基于 2.0 版 编写 。 


系统 要 求 和 先决 条 件 


Yii 2.0 需要 PHP 5.4.0 或 以 上 版 本 支持 。 你 可 以 通过 运行 任何 Yii 发 行 包 中 附带 的 系统 要 求 检 
查 器 查看 每 个 具体 特性 所 需 的 PHP 配置 。 使 用 Yii 需要 对 面向 对 象 编程 (OOP) 有 基本 了 
解 ， 因 为 Yii 是 一 个 纯 面 向 对 象 的 框架 。Yii 2.0 还 使 用 了 PHP 的 最 新 特性 ， 例 如 命名 空间 和 
Trait (特质 ) 。 理 解 这些 概 念 季 有 助 于 你 更 快 地 掌握 Yii 2.0。 


从 Yii 1.1 升 级 到 Yii2 - Yii2 教 程 


从 Yii 1.1 升级 


2.0 版 框架 是 完全 重 写 的 ， 在 1.1 和 2.0 两 个 版 本 之 间 存 在 相当 多 差异 。 因 此 从 1.1 版 升级 并 
不 像 小 版 本 间 的 跨越 那么 简单 ， 通 过 本 指南 你 将 会 了 解 两 个 版 本 间 主 要 的 不 同 之 和 处。 如果 你 
之 前 没有 用 过 Yii 1.1， 可 以 跳 过 本 章 ， 直 接 从 "入 门 篇 "开始 读 起 。 请 注意 ，Yii 2.0 引入 了 很 多 
本 章 并 没有 涉及 到 的 新 功能 。 强 烈 建议 你 通读 整 部 权威 指南 来 了 解 所 有 新 特性 。 这 样 有 可 能 
会 发 现 一 些 以 前 你 要 自己 开发 的 功能 ， 而 现在 已 经 被 包含 在 核心 代码 中 了 。 


一 站 
安装 


Yii 2.0 完全 拥抱 Composer， 它 是 PHP 中 的 一 个 依赖 管理 工具 。 核 心 框架 以 及 扩展 的 安装 都 
通过 Composer 来 处 理 。 想 要 了 解 更 多 如 何 安装 Yii 2.0 请 参阅 本 指南 的 安装 Yii 章节 。 如 果 
你 想 创建 新 扩展 ， 或 者 把 你 已 有 的 Yii 1.1 的 扩展 改写 成 兼容 2.0 的 版 本 ， 你 可 以 参考 创建 扩 
展 章节 。 


PHP 需求 


Yii 2.0 需要 PHP 5.4 或 更 高 版 本 ， 该 版 本 相对 于 Yii 1.1 所 需求 的 PHP 5.2 而 言 有 巨大 的 改 
进 。 因 此 在 语言 层面 上 有 很 多 的 值得 注意 的 不 同 之 处 。 下 面 是 PHP 层 的 主要 变化 汇总 : - 命 

空间 - 匿名 函数 - 数组 短语 法 [.. .元素 ...] 用 于 取代 array(.. .元 素 ...) - 视图 文件 中 的 短 格 
式 echo 标签 <?= ， 自 PHP 5.4 起 总 会 被 识别 并 且 合 法 ， 无 论 short _open tag 的 设置 是 什 
么 ， 可 以 安全 使 用 。- SPL 类 和 接口 - 延迟 静态 绑 定 - 日 期 和 时 间 - Traits- intl Yii 2.0 使 用 PHP 
扩展 intl 来 支持 国际 化 的 相关 功能 。 


命名 空间 


Yii 2.0 里 最 明显 的 改动 就 数 命 名 空间 的 使 用 了 。 几乎 每 一 个 核心 类 都 引入 了 命名 空间 ， 上 比如 
yii\web\Request 。1.1 版 用 于 类 名 前 的 字母 “C” 已 经 不 再 使 用 。 当 前 的 命名 规范 与 目录 结构 
相 吻 合 。 例 如 ， yii\web\Request 就 表明 对 应 的 类 文件 是 Yii 框架 文件 夹 下 的 
web/Request.php 文件 。( 有 了 Yii 的 类 自动 加 载 器 ， 你 可 以 直接 使 用 全 部 核心 类 而 不 需要 显 式 
包含 具体 文件 。) 


组 件 (Component) 与 对 象 (Object) 


Yii 2.0 把 1.1 里 的 ccomponent 类 拆 分 成 了 两 个 类 : yii\base\object 和 
yii\base\Component 。 yii\base\0bject|object 类 是 一 个 轻 量 级 的 基 类 ， 你 可 以 通过 getters 
和 setters 来 定义 object 的 属性 。 yii\base\Component|Ccomponent 类 继承 自 


yiixbaseNxobject|object ， 同 时 进一步 支持 事件 和 行为 。 如 果 你 不 需要 用 到 事件 或 行为 ， 应 
该 考虑 使 用 yii\base\objectlobject 类 作为 基 类 。 这 通常 是 表示 基本 数据 结构 的 类 。 


对 象 的 配置 


yii\base\0bject|object 类 引入 了 一 种 统一 对 象 配置 的 方法 。 所 有 yii\base\object|object 
的 子 类 都 应 该 用 以 下 方法 声明 它 的 构造 方法 (如 果 需 要 的 话 )， 以 正确 配置 它 自身 : 


class MyClass extends \yii\base\0Object 
public function __construct($parami, $param2, $config = []) 
// ..， 配置 生效 前 的 初始 化 过 程 


parent::__construct($config); 


} 
public function init() 
parent::init(); 


// ，. .配置 生效 后 的 初始 化 过 程 


在 上 面 的 例子 里 ， 构 造 方法 的 最 后 一 个 参数 必须 输入 一 个 配置 数组 ， 包 含 一 系列 用 于 在 方法 
结尾 初始 化 相关 属性 的 键 值 对 。 你 可 以 重 写 yii\base\0bject::init()|init() 方法 来 执行 一 些 
需要 在 配置 生效 后 进行 的 初始 化 工作 。 你 可 以 通过 遵循 以 下 约定 俗 成 的 编码 习惯 ， 来 使 用 配 
置 数 组 创建 并 配置 新 的 对 象 : 


$object = Yii::createOobject([ 
'class' => 'MyClass', 
"property1' => "abc'， 
"property2' => 'cde', 

], [$param1i, $param2]); 


更 多 有 关 配 置 的 细节 可 以 在 配置 章节 找到 。 


事件 (Event) 


在 Yii1 中， 通常 通过 定义 on 开头 的 方法 (例如 onBeforeSave ) 来 创建 事件 。 而 在 Yii 2 中 ， 
你 可 以 使 用 任意 的 事件 名 Ts 同时 通过 调用 yii\base\Component::trigger()|trigger() 方法 
来 触发 相关 事件 : 


$event = new \yii\base\Event; 
$component->trigger($eventName, $event); 


要 给 事件 附加 一 个 事件 句柄 (Event Handler 或 者 叫 事 件 处 理 器 )， 需 要 使 用 


yii\base\Component::on()|on() 方法 : 


$component->on($eventName, $handler); 
// 要 解除 相关 句柄 ， 使 用 off 方法 : 
// $component->off($eventName, $handler); 


事件 功能 还 有 更 多 增强 之 处 。 要 了 解 它 们 ， 请 查看 事件 章节 。 


路 径 别 名 (Path Alias) 


Yii 2.0 将 路 径 别 名 的 应 用 扩大 至 文件 /目录 路 径 和 URL。Yii2.0 中 路 径 别 名 必须 以 @ 符号 开 
头 ， 以 区 别 于 普通 文件 目录 路 径 或 URL。 例 如 @yii 就 是 指向 Yii 安装 目录 的 别名 。 绝 大 多 
数 Yii 核心 代码 都 支持 别名 。 例 如 yii\caching\Filecache::cachePath 就 同时 支持 路 径 别 名 或 
普通 的 目录 地 址 。 路 径 别 名 也 和 类 的 命名 空间 密切 相关 。 建 议 给 每 一 个 根 命名 空间 定义 一 个 
路 径 别 名 ， 从 而 无 须 额外 配置 ， 便 可 启动 Yii 的 类 自动 加 载 机 制 。 例 如 ， 因 为 有 @yii 指向 
Yii 安装 目录 ， 那 类 似 yii\web\Request 的 类 就 能 被 Yii 自动 加 载 。 同 理 ， 若 你 用 了 一 个 第 三 
方 的 类 库 ， 如 Zend Framework， 你 只 需 定 义 一 个 名 为 @zend 的 路 径 别 名 指向 该 框架 的 安装 
目录 。 之 后 Yii 就 可 以 自动 加 载 任 意 Zend Framework 中 的 类 了 。 更 多 路 径 别 名 信息 请 参阅 路 
径 别 名 章节 。 


视图 (View) 


ee $this 不 再 指向 当前 控制 器 或 小 部 件 ， 而 是 指 
向 视图 对 象 ， 它 是 2.0 中 引入 的 全 新 概念 。 视 图 对 象 为 yii\web\view 的 实例 ， 他 代表 了 
MVC ae 如 果 你 想 要 在 视图 中 访问 一 个 控制 器 或 小 部 件 ， 可 以 使 用 
$this->context 。 要 在 其 他 视图 里 泻 染 一 个 局 部 视图 ， 使 用 $this->render(),， 而 不 是 
$this->renderPartial() 。 render() 现在 只 返 芭 回 演 染 # 吉 果 ， 而 不 是 直接 显示 它 ， 所 以 现在 你 
必须 显 式 地 把 它 echo 出 来 。 像 这 样 : 


echo $this->render('_item', ['item' => $item]); 


除了 使 用 PHP 作为 主要 的 模板 语言 ，Yii 2.0 也 装备 了 两 种 流行 模板 引擎 的 官方 支持 : Smarty 
和 Twig。 过 去 的 Prado 模板 引擎 不 再 被 支持 。 要 使 用 这 些 模板 引擎 ， 你 需要 配置 view 应 用 
组 件 ， 给 它 设置 yii\base\View::$renderers|View::$renderers 属性 。 具体 请 参 阅 樟 板 引 擎 章 
节 。 


模型 (Model) 


ee yii\base\Model 作为 模型 基 类 ， 类 似 于 1.1 的 cModel 。 cFormModel 被 完全 弃 

， 现 在 要 创建 表单 模型 类 ， 可 以 通过 继承 yii\base\Model 类 来 实现 。Yii 2.0 引进 了 名 为 
yii\base\Model::scenarios()|scenarios() 的 新 方法 来 声 明 支 持 的 场景 ， 并 指明 在 哪个 场景 下 
某 属 性 必须 经 过 验证 ， 可 否 被 视 为 安全 值 等 等 。 如 : 


public function scenarios() 


{ 
return [ 
'backend' => ['email', 'role'], 
'frontend' => ['email', '!role'], 
]; 
} 


上 面 的 代码 声明 了 两 个 场景 : backend 和 frontend 。 对 于 backend 场景 ， email 和 
role 属性 值 都 是 安全 的 ， 且 能 进行 批量 赋值 。 对 于 frontend 场景 ，email 能 批量 赋值 而 
role 不 能 。 email 和 role 都 必须 通过 规则 验证 。 yii\base\Model::rules()|rules() 方 
法 仍 用 于 声明 验证 规则 。 注 意 ， 由 于 引入 了 yii\base\Model::scenarios()|scenarios() ， 现 在 
已 经 没有 unsafe 验证 器 了 。 大 多 数 情况 下 ， 如 果 yii\base\Model::rules()|rules() 方法 内 
已 经 完整 地 指定 场景 了 ， 那 就 不 必 覆 写 yii\base\Model::scenarios()|scenarios(), 也 不 必 声 
明 unsafe 属性 值 。 要 了 解 更 多 有 关 模 型 的 细节 ， 请 参考 模型 章节 。 


控制 器 (Controller) 


Yii 2.0 使 用 yii\web\controller 作为 控制 器 的 基 类 ， 类 似 于 1.1 的 cwebcontroller 。 使 用 
yii\base\Action 作为 操作 类 的 基 类 。 这 些 变 化 最 明显 的 影响 是 ， 当 你 在 宇 控 制 器 操作 的 代码 
时 ， 应 该 返回 (return) 要 泻 染 的 内 容 而 不 是 输出 (echo) 它 : 


public function actionView($id) 


$model = \app\models\Post::findone($id); 
If ($model) { 
return $this->render('view', ['model' => $model]); 
} else { 
throw new \yii\web\NotFoundHttpException; 
} 


请 查看 控制 器 (Controller) 章节 了 解 有 关 控 制 器 的 更 多 细节 。 


小 部 件 (Widget) 


Yii 2.0 使 用 yii\base\widget 作为 小 部 件 基 类 ， 类 似 于 1.1 的 cwidget 。 为 了 让 框架 获得 更 
好 的 IDE 支持 ，Yii 2.0 引进 了 一 个 调用 小 部 件 的 新 语法 。 包 含 
yii\base\Widget::begin()|begin() ， yiixbasexwWidget::end()|end() 和 

yii\base\Widget: :widget()|widget() 三 个 静态 方法 ， 用 法 如 下 : 


use yii\widgets\Menu; 
use yii\widgets\ActiveForm; 


// 注意 必须 **"echo"** 结果 以 显示 内 容 
echo Menu::widget(['items' => $items]); 
// 传递 一 个 用 于 初始 化 对 象 属性 的 数组 
$form = ActiveForm: :begin([ 
"options' => ['class' => 'form-horizontal'], 
'fieldconfig' => ['inputOptions' => ['class' => 'input-xlarge'., 


1); 
..， 表 单 输入 栏 都 在 这 里 ... 
ActiveForm: :end(); 


更 多 细节 请 参阅 小 部 件 章节 。 


主题 (Theme) 


2.0 主题 的 运作 方式 跟 以 往 完 全 不 同 了 。 它 们 现在 基于 路 径 映 射 机 制 ， 该 机 制 会 把 一 个 源 视 图 
文件 的 路 径 映 射 到 一 个 主题 视图 文件 路 径 。 举 例 来 说 ， 如 果 路 径 映 射 为 

['/web/views' => '/web/themes/basic'] ， 那 么 /web/views/site/index.php 视图 经 过 主题 修 
饰 的 版 本 就 会 是 /web/themes/basic/site/index.php 。 也 因此 让 主题 现在 可 以 应 用 在 任何 视图 
文件 之 上 ， 其 至 是 泻 染 控制 器 上 下 文 环境 之 外 的 视图 文件 或 小 部 件 。 同 样 ， cThemeManager 
组 件 已 经 被 移 除了 。 取 而 代 之 的 theme 成 为 了 view 应 用 组 件 的 一 个 可 配置 属性 。 更 多 细 


节 请 参考 主题 章节 。 


控制 台 应 用 (Console Application) 


控制 台 应 用 现在 如 普通 的 Web 应 用 程序 一 样 ， 由 控制 器 组 成 ， 控 制 台 的 控制 器 继承 自 
yii\console\Controller ， 类 似 于 1.1 的 CConsoleCommand 。 运行 控制 台 命 邻 使 用 

yii <route> ， 其 中 <route> 代表 控制 器 的 路 由 (如 sitemap/index )。 人 额外 的 匿名 参数 传递 
到 对 应 的 控制 器 操作 方法 ， 而 有 名 的 参数 根据 yii\console\Controller::options() 的 声明 来 
解析 。Yii 2.0 支持 基于 代码 注释 自动 生成 相 的 关 命令 行 帮 助 (help) 信 息 。 更 多 细节 请 参阅 控制 


人 全 从 主 站 
口 PP 人 全 时 全 o 


国际 化 (I18N) 


Yii 2.0 移 除 了 原来 内 置 的 日 期 格式 器 和 数字 格式 器 ， 为 了 支持 PECL intl PHP module(PHP 
的 国际 化 扩展 ) 的 使 用 。 消 息 翻 译 现在 由 ilsn 上 应用 组 件 执 行 。 该 组 件 管理 一 系列 消息 源 ， 人 允 
许 使 用 基于 消息 类 别 的 不 同 消息 源 。 更 多 细节 请 参阅 国际 化 (Internationalization) 章 节 。 


操作 过 滤器 (Action Filters) 


操作 的 过 滤 现 在 通过 行为 (behavion) 来 实现 。 要 定义 一 个 新 的 ， 自 定义 的 过 滤器 ， 请 继承 
yii\base\ActionFilter 类 。 要 使 用 一 个 过 滤器 ， 需 要 把 过 滤器 类 作为 一 个 behavior 绑 定 到 
控制 器 上 。 例 如 ， 要 使 用 yii\filters\Accesscontrol 过 滤器 ， 你 需要 在 控制 器 内 添加 如 下 代 
码 : 


public function behaviors() 


{ 
return [ 
"access' => |[ 
'class' => 'yii\filters\AccessControl', 
'rules' => [ 
['allow' => true, 'actions' => ['admin'], 'roles' => ['@' ， 
]， 
]， 
] 


前 端 资 源 (Assets) 


Yii 2.0 引入 了 一 个 新 的 概念 ， 称 为 资源 包 (Asset Bundle)， 以 代替 1.1 a 个 资 
源 包 是 一 个 目录 下 的 资源 文件 集合 (如 JavaScript 文件 、CSS 文件 、 图 片 文 件 等 )。 每 一 个 资 
源 包 被 表示 为 一 个 类 ， 该 类 继承 自 yii\web\AssetBundle 。 用 
yii\web\AssetBundle::register() 方法 注册 一 个 资源 包 后 ， 就 使 它 的 资源 可 被 Web 访问 了 ， 
注册 了 资源 包 的 页 面 会 自动 包含 和 引用 资源 包 内 指定 的 JS 和 CSS 文件 。 更 多 细节 请 参阅 前 
端 资 源 管理 (Asset) 章节 。 


助手 类 (Helpers) 


Yii 2.0 很 多 常用 的 静态 助手 类 ， 包 插 : yii\helpers\Html yii\helpers\ArrayHelper 
yii\helpers\StringHelper yii\helpers\FileHelper * yii\helpers\Json 请 参 参考 助手 一 览 章 


来 了 解 更 多 。 


表单 


Yii 2.0 引进 了 表单 栏 (field) 的 概念 ， 用 来 创建 一 个 基于 yii\widgets\ActiveForm 的 表单 。 一 个 
表单 栏 是 一 个 由 标签 、 输 入 框 、 错 误 消 息 (可 能 还 有 提示 文字 ) 组 成 的 容器 ， 被 表示 为 
yii\widgets\ActiveField|ActiveField 对 象 。 使 用 表单 栏 建立 表单 的 过 4 程 比 以 前 更 整洁 利落 : 


<?php field($model, 'username') ?> 
<?php field($model, 'password')->passwordInput() ?> 


请 参考 创建 表单 章节 来 了 解 更 多 细节 。 


查询 生成 器 (Query Builder) 


Yii 1.1 中 ， 查 询 语句 的 生成 分 散在 多 个 类 中 ， 包 括 cpbcommand ， cpbcriteria 以 及 
cDbcommandBuilder 。Yii 2.0 以 yii\db\Query|Query 对 象 的 形式 表示 一 个 数据 库 查询 ， 这 个 
对 象 使 用 yii\db\QueryBuilder |QueryBuilder 在 幕后 生成 SQL 语句 。 例如 : 


$query = new \yii\db\Query(); 
$query->select('id, name') 
->from('user') 
->limit(10); 
$command = $query->createCommand(); 
$sql = $command->sql; 
$rows = $command->queryAll(); 


最 重要 的 是 ， 这 些 查 询 生成 方法 还 可 以 和 活动 记录 配合 使 用 。 请 参考 查询 生成 器 (Query 
Builder) 章 节 了 解 更 多 内 容 。 


活动 记录 (Active Record) 


Yii 2.0 的 活动 记录 改动 了 很 多 。 两 个 最 显而易见 的 改动 分 别 涉及 查询 语句 的 生成 (query 
building) 和 关联 查询 的 义理 (relational query handling)。1.1 中 的 cpbcriteria 类 在 Yii2 中 被 
yii\db\ActiveQuery 所 替代 。 这 个 类 是 继承 自 yii\db\Query ， 因 此 也 继承 了 所 有 查询 生成 方 
法 。 开 始 拼 装 一 个 查询 可 以 调用 yii\db\ActiveRecord::find() 方法 进行 : 
// 检索 所 有 * 活 动 的 * 客户 和 订单 ， 并 以 ID 排序 : 
$customers = Customer::find() 
->where(['status' => $active]) 


->orderBy('id') 
->all( ); 


要 声明 一 个 关联 关系 ， 只 需 简单 地 定义 一 个 getter 方法 来 返回 一 个 
yii\db\ActiveQuery|ActiveQuery 对 象 。getter 方法 定义 的 属性 名 ( 译 者 注 : 即 getOrders() 中 
的 orders) 表 示 关 联 关系 名 。 如 ， 以 下 代码 声明 了 一 个 名 为 orders 的 关系 (1.1 中 必须 在 
relations() 方法 内 声明 关系 ) : 


class Customer extends \yii\db\ActiveRecord 
public function getOrders() 


return $this->hasMany('Order', ['customer_id' => "id']); 


现在 你 就 可 以 通过 调用 $customer->orders 来 访问 关联 表 中 某 用 户 的 订单 了 。 你 还 可 以 用 以 
下 代码 进行 一 场 指 定 条 件 的 实时 关联 查询 : 


$orders = $customer->getOrders()->andwhere('status=1')->all(); 


当 贪 禁 加 载 一 段 关 联 关 系 时 ，Yii 2.0 和 1.1 的 运作 机 理 并 不 相同 。 具 体 来 说 ， 在 1.1 中 使 用 一 
条 JOIN 语句 同时 查询 主 表 和 关联 表 记 录 。 人 在 Yii 2.0 中 会 使 用 两 个 没有 JOIN 的 SQL 语句 : 
第 一 条 语句 取 回 主 表 记录 ， 第 二 条 通过 主 表 记录 经 主键 第 选 后 查询 关联 表 记 录 。 当 生成 返回 
大 量 记 录 的 查询 时 ， 可 以 链 式 书 写 yii\db\ActiveQuery::asArray()|asArray() 方法 ， 这 样 会 
以 数组 的 形式 返回 查询 结果 ， 而 不 必 返 回 yii\db\ActiveRecord|ActiveRecord 对 象 ， 这 能 显著 
降低 因 大 量 记 录 读 取 所 消耗 的 CPU 时 间 和 内 存 。 如 : 


$customers = Customer::find()->asArray()->all(); 


另 一 个 改变 是 你 不 能 再 通过 公共 数据 定 属性 (Attribute) 的 默认 值 了 。 如 果 你 需要 这 么 做 的 话 ， 
可 以 在 你 的 记录 类 的 init 方法 中 设置 它们 。 


public function init() 


parent::init(); 
$this->status = self::STATUS_ NEwW; 


鲁 几 何 时 ， 在 1.1 中 重 写 一 个 活动 记录 类 的 构造 方法 (Constructor) 会 导致 一 些 问题 。 它 们 不 会 
在 2.0 中 出 现 了 。 需 要 注意 的 是 ， 如 果 你 需要 在 构造 方法 中 添加 一 些 人 参数 ， 臣 怕 必须 重 写 
yii\db\ActiveRecord::instantiate() 方法 。 活动 记录 方面 还 有 很 多 其 他 的 变化 与 改进 请 参 
考 活动 记录 章节 以 了 解 更 多 细节 。 


用 户 及 身份 验证 接口 (lIdentityInterface) 


1.1 中 的 cwebuser 类 现在 被 yii\wep\user 所 取代 ， 随 之 cuserIdentity 类 也 不 在 了 。 与 之 
相对 的 ， 为 达到 相同 目的 ， 你 可 以 实现 yii\web\IdentityInterface 接口 ， 它 使 用 起 来 更 直 
观 。 在 高 级 应 用 模版 里 提供 了 一 个 这 样 的 一 个 例子 。 要 了 解 更 多 细节 请 参考 认证 
(Authentication)， 授 权 (Authorization) 以 及 高 级 应 用 模版 这 三 个 章节 。 


URL 管理 


Yii 2.0 的 URL 管理 跟 1.1 中 很 像 。 一 个 主要 的 改进 是 现在 的 URL 管理 支持 可 选 参数 了 。 比 
如 ， 如 果 你 在 2.0 中 定义 了 一 个 下 面 这 样 的 规则 ， 那 么 它 可 以 同时 匹配 post/popular 和 
post/1/popular 两 种 URL。 而 在 1.1 中 为 达成 相同 效果 ， 必 须要 使 用 两 条 规则 。 


"pattern' => 'post/<page:\d+>/<tag>', 

'route' => 'post/index', 

"defaults' => ['page' => 1], 
]</tag></page: \d+> 


请 参考 URL 解析 和 生成 章节 ， 以 了 解 更 多 细节 。 


同时 使 用 Yii 1.1 和 2.x 


如 果 你 有 一 些 遗 留 的 Yii 1.1 代码 ， 需 要 跟 Yii 2.0 一 起 使 用 ， 可 以 参考 1.1 和 2.0 共用 章节 。 


TutorialsPoint 后 病 用 性 


安 妆 Yii2 - Yii2 教 程 


安装 Yii============== 你 可 以 通过 两 种 方式 安装 Yii : 使 用 Composer 或 下 载 一 个 当 档 文 
件 。 推 荐 使 用 前 者 ， 这 样 只 需 执 行 一 条 简单 的 命令 就 可 以 安装 新 的 扩展 或 更 新 Yii 了 。> 注 

意 : 和 Yii 1 不 同 ， 以 标准 方式 安装 Yii 2 时 会 同时 下 载 并 安装 框架 本 身 和 一 个 应 用 程序 的 基本 
上 骨架。 通过 Composer 安装 ----------------------- 如 果 还 没有 安装 Composer， 你 可 以 按 
getcomposer.org 中 的 方法 安装 。 在 Linux 和 Mac OS X 中 可 以 运行 如 下 命令 : 


curl -s http://getcomposer.org/installer | php 
mv composer.phar /usr/local/bin/composer 


在 Windows 中 ， 你 需要 下 载 并 运行 Composer-Setup.exe。 如 果 遇 到 任何 问题 或 者 想 更 深入 
地 学 习 Composer， 请 参考 Composer 文档 (英文 )，Composer 中 文 。Composer 安装 后 ， 切 
换 到 一 个 可 通过 Web 访问 的 上 目录， 执行 如 下 命令 即 可 安装 Yii : 


composer create-project --prefer-dist yiisoft/yii2-app-basic basic 


如 上 命令 会 将 Yii 安装 在 名 为 ”basic 的 目录 中 。> 技巧 : 如 果 你 想 安 装 Yii 的 最 新 开发 版 本 ， 
可 以 使 用 如 下 命令 ， 它 添加 了 一 个 stability 选项 (中 文 版 ): 


composer create-project --prefer-dist --stability=dev yiisoft/yii2-app-basic basic 


注意 ，Yii 的 开发 版 (dev 版 ) 不 应 该 用 于 生产 环境 中 ， 它 可 能 会 破坏 运行 中 的 代码 。 通 过 
为 档 文件 安装 通过 为 档 文件 安装 Yii 包括 两 个 步骤 : 1. 从 
yiiframework.com 下 载 归 档 文件 。2. 将 下 载 的 文件 解压 缩 到 Web 目录 中 。3. 修改 
config/web.php 文件 ， 给 cookievalidationkey 配置 项 添加 一 个 密 钥 ( 若 你 通过 
Composer 安装 ， 则 此 步骤 会 自动 完成 ) : 


php // !44 在 下 面 插入 一 段 密 钥 ( 若 为 空 ) - 以 供 cookie validation 的 需要 'cookieValidationKey' = 
其 他 安装 方式 -------------------------- 上 文 介绍 了 两 种 安装 Yii 的 方法 ， 安 装 的 同时 也 会 创建 


一 个 立即 可 用 的 Web 应 用 程序 。 对 于 小 的 项 目 或 用 于 学 习 上 手 ， 这 都 是 一 个 不 错 的 起 
点 。 但 是 其 他 的 安装 方式 也 存在 : 如 果 你 只 想 安装 核心 框架 ， 然 后 从 需 开 始 构建 整个 属 
于 你 自己 的 应 用 程序 模版 ， 可 以 参考 从 头 构建 自 定义 模版 一 节 的 介绍 。 如 果 你 要 开发 一 
个 更 复杂 的 应 用 ， 可 以 更 好 地 适用 于 团队 开发 环境 的 ， 可 以 考虑 安装 高 级 应 用 模版 。 验 
证 安装 的 结果 -------------------------- 安装 完成 后 ， 就 可 以 使 用 浏览 器 通过 如 下 URL 访问 刚 
安装 完 的 Yii 应 用 了 : 


http://localhost/basic/web/index.php 


十 Vr WD 2 上 于 口 门 
XT - “了 子 人 14 王 PA fs 


这 个 URL 假设 你 将 Yii 安装 到 了 一 个 位 于 Web 文档 根 目 录 下 的 basic 目录 中 ， 且 该 Web 
服务 器 正 运行 在 你 自己 的 电脑 上 ( localhost )。 你 可 能 需要 将 其 调整 为 适应 自己 的 安装 环境 。! 
[Yii 安装 成 功 ] 你 应 该 可 以 在 浏览 器 中 看 到 如 上 所 示 的 “Congratulations!” 页 面 。 如 果 没 有 ， 请 
通过 以 下 任意 一 种 方式 ， 检 查 当 前 PHP 环境 是 否 满足 Yii 最 基本 需求 : 通过 浏览 器 访问 URL 
http://1localhost/basic/requirements.php 执行 如 下 命令 : 


http://localhost/basic/web/index.php 


你 需要 配置 好 PHP 安装 环境 ， 使 其 符合 Yii 的 最 小 需求 。 主 要 是 需要 PHP 5.4 以 上 版 本 。 如 
果 应 用 需要 用 到 数据 库 ， 那 还 要 安装 PDO PHP 扩展 和 相应 的 数据 库 驱 动 (例如 访问 MySQL 
数据 库 所 需 的 pdo_mysql )。 配 置 Web 服务 器 ----------------------- > 补充 : 如 果 你 现在 只 是 要 试 
用 Yii 而 不 是 将 其 部 署 到 生产 环境 中 ， 本 小 节 可 以 跳 过 。 通 过 上 述 方法 安装 的 应 用 程序 在 
Windows，Max OS X，Linux 中 的 Apache HTTP 服务 器 或 Nginx HTTP 服务 器 上 都 可 以 直 
接 运 行 。 在 生产 环境 的 服务 器 上 ， 你 可 能 会 想 配 置 服务 器 让 应 用 程序 可 以 通过 URL 

http://www.example.com/index.php 访问 而 不 是 

http://www.example.com/basic/web/index.php 。 这 种 配置 需要 将 Web 服务 器 的 文档 根 目 录 指 
向 basic/web 目录 。 可 能 你 还 会 想 隐藏 掉 URL 中 的 index.php ， 具 体 细 节 在 URL 解析 和 生 
成 一 章 中 有 介绍 ， 你 将 学 到 如 何 配置 Apache 或 Nginx 服务 器 实现 这 些 目标 。> 补 充 : 将 
basic/web 设置 为 文档 根 目 录 ， 可 以 防止 终端 用 户 访问 basic/web 相 邻 目录 中 的 私有 应 用 代 
码 和 敏感 数据 文件 。 茶 止 对 其 他 目录 的 访问 是 一 个 不 错 的 安全 改进 。> 补 充 : 如 果 你 的 应 用 程 
序 将 来 要 运行 在 共享 虚拟 主机 环境 中 ， 没 有 修改 其 Web 服务 器 配置 的 权限 ， 你 依然 可 以 通过 
调整 应 用 的 结构 来 提升 安全 性 。 详 情 请 参考 共享 主机 环境 一 章 。 故 # 推荐 使 用 的 Apache 配 
置 在 Apache 的 httpd.conf 文件 或 在 一 个 虚拟 主机 配置 文件 中 使 用 如 下 配置 。 注 意 ， 你 应 
该 业 path/to/basic/web 替换 为 实际 的 basic/web 目录 。 





# 设置 文档 根 目录 为 “basic/web” 
DocumentRoot "path/to/basic/web" 
<directory basic="" path="" to="">RewriteEngine on 


# 如 果 请 求 的 是 真实 存在 的 文件 或 目录 ， 直 接 访 问 
RewriteCond %{REQUEST_FILENAME} !-f 
RewriteCond %{REQUEST_FILENAME} !-d 

# 如 果 请 求 的 不 是 真实 文件 或 目录 ， 分 发 请 求 至 index.php 
RewriteRule . index.php 





# .. .其 它 设置 .. .</directory> 


推荐 使 用 的 Nginx 配置 为 了 使 用 Nginx， 你 应 该 已 经 将 PHP 安 

妆 为 FPM SAPI 了 。 使 用 如 下 Nginx 配置 ， 将 
path/to/basic/web 蔡 换 为 实际 的 basic/web 目 

录 ， mysite.local 替换 为 实际 的 主机 名 以 提供 服务 。 


server { 
charset utf-8; 
client_max_body_size 128M; 


listen 80; ## 监听 ijpv4 上 的 80 端口 
#listen [::]:80 default_server ipv6only=on; ## 监听 ipv6 上 的 80 端口 


server_name mysite.1local; 
root /path/to/basic/web; 
index index.php; 


access_log /path/to/basic/log/access.10g main; 
error_log /path/to/basic/log/error.1og; 


location / { 
# 如 果 找 不 到 真实 存在 的 文件 ， 把 请 求 重 定向 给 index.php 
try_files $uri $uri/ /index.php?$args; 

} 


# 若 取 消 下 面 这 段 的 注释 ， 可 避免 Yii 接管 不 存在 文件 的 处 理 过 程 (404) 
#1location ~ ,(jslcsslpngljpglgiflswflicolpdflmov|flalziplrar)$ { 
# try_files $uri =404; 

#} 

#error_page 404 /404.htmll; 





location ~ .php$ { 
include fastcgi.conf,; 
fastcgi_pass 127.0.0.1:9000; 
#fastcgi_pass unix:/var/run/php5-fpm.sock; 


} 

location ~ /.(ht|lsvnlgit) { 
deny all; 

} 


使 用 该 配置 时 ， 你 还 应 该 在 php.ini 文件 中 设置 cgi.fix_pathinfo=0 ， 能 避免 掉 很 多 不 必 
要 的 stat() 系统 调用 。 还 要 注意 当 运 行 一 个 HTTPS 服务 器 时 ， 需 要 添加 
fastcgi_param HTTPS on; 一 行 ， 这 样 Yi 才能 正确 地 判断 连接 是 否 安全 。 


运行 应 用 - Yii2 教 程 


运行 应 用 


安装 Yii 后 ， 就 有 了 一 个 运行 中 的 Yii 上 应用， 根据 配置 的 不 同 ， 可 以 通过 
http://hostname/basic/web/index.php 或 http://hostname/index.php 访问 。 本 章节 将 介绍 应 
用 的 内 建功 能 ， 如 何 组 织 代码 ， 以 及 一 般 情况 下 应 用 如 何 处 理 请 求 。 > 补充 : 为 简单 起 见 ， 
在 整个 "入门 "板块 都 假定 你 已 经 把 basic/web 设 为 Web 服务 器 根 目录 并 配置 完毕 ， 你 访问 应 
用 的 地 址 会 是 _http://lostname/index.php 或 类 似 的 。 请 按 需 调整 URL。 


功能 


一 个 安装 完 的 基本 应 用 包含 四 页 : * 主页 ， 当 你 访问 http://hostname/index.php 时 显示 ,* 
“About 页 ，*“Contact” 页 ， 显示 一 个 联系 表单 ， 人 允许 终端 用 户 通过 Email 联系 你 ， 

“Login” 页 ， 显示 一 个 登录 表单 ， 用 来 验证 终端 用 户 。 试 着 用 “admin/admin” 登录 ， 你 可 以 看 
到 当前 是 登录 状态 ， 已 经 可 以 "退出 登录 "了 。 这 些 页 面 使 用 同一 个 头 部 和 尾部 。 头 部 包含 了 
一 个 可 以 在 不 同 页 面 间 切 换 的 导航 栏 。 在 浏览 器 底部 可 以 看 到 一 个 工具 栏 。 这 是 Yii 提供 的 很 
有 用 的 调试 工具 ， 可 以 记录 并 显示 大 量 的 调试 信息 ， 例 如 日 志 信 息 ， 响 应 状态 ， 数 据 库 查询 
等 等 。 


应 用 结构 


应 用 中 最 重要 的 目录 和 文件 (假设 应 用 根 目 录 是 basic ) 





basic/ 应 用 根 目录 


composer .json Composer 配置 文件 ， 描 述 包 信息 
config/ 包含 应 用 配置 及 其 它 配 置 
console.php 控制 台 应 用 配置 信息 
web .php web 应 用 配置 信息 
commands/ 包含 控制 台 命 命 类 
controllers/ 包含 控制 器 类 
models/ 包含 模型 类 
runtime/ 包含 Yii 在 运行 时 生成 的 文件 ， 例 如 日 志和 缓存 文件 
vendor/ 包含 已 经 安装 的 Composer 包 ， 包 括 Yii 框架 自身 
views/ 包含 视图 文件 
web/ Web 应 用 根 目 录 ， 包 含 Web 入 口 文件 
assets/ 包含 Yii 发 布 的 资源 文件 (javascript 和 css) 
index.php 应 用 入 口 文件 
yii Yii 控制 台 命 舍 执 行 脚本 


一 般 来 说 ， 应 用 中 的 文件 可 被 分 为 两 类 : 在 basic/web 下 的 和 在 其 它 目 录 下 的 。 前 者 可 以 直 
接 通过 HTTP 访问 (例如 浏览 器 ) ， 后 者 不 能 也 不 应 该 被 直接 访问 。 Yii 实现 了 模型 -视图 - 控 
制 器 (MVC) 设 计 模式 ， 这 点 在 上 述 目 录 结 构 中 也 得 以 体现 。 models 目录 包含 了 所 有 [模型 


类 ]， views 目录 包含 了 所 有 [视图 脚本 ]， controllers 目录 包含 了 所 有 [控制 器 类 ]。 以 下 图 
表 展 示 了 一 个 应 用 的 静态 结构 : [应 用 静态 结构 ] 每 个 应 用 都 有 一 个 人 口 脚本 

web/index.php ， 这 是 整个 应 用 中 唯一 可 以 访问 的 PHP 脚本。 入口 脚 本 接受 一 个 Web 请 求 并 
创建 [应 用 ] 实 例 去 处 理 它 。 [应 用 ] 在 它 的 [组 建 ] 辅 助 下 解析 请 求 ， 并 分 派 请 求 至 MVC 元 素 。 
[视图 ] 使 用 [小 部 件 ] 去 创建 复杂 和 动态 的 用 户 界面 。 


请 求生 命 周 期 


以 下 图 表 展 示 了 一 个 应 用 如 何 义理 请 求 : [请 求生 命 周期 ] 1. 用 户 向 [入 口 脚本 ] web/index.php 
发 起 请 求 。 2. 入 口 脚本 加 载 应 用 [配置 ] 并 创建 一 个 [应 用 ] 实 例 去 处 理 请 求 。 3. 应 用 通过 [请 求 ] 
组 件 解析 请 求 的 [路 由 ]。 4. 应 用 创建 一 个 [控制 器 ] 实 例 去 处 理 请 求 。 5. 控制 器 创建 一 个 [操作 ] 
实例 并 针对 操作 执行 过 滤器 。 6. 如 果 任 何 一 个 过 滤器 返回 失败 ， 则 操作 退出 。 7. 如 果 所 有 过 
滤器 都 通过 ， 操 作 将 被 执行 。 8. 操作 会 加 载 一 个 数据 模型 ， 或 许 是 来 自 数据 库 。 9. 操作 会 演 
染 一 个 视图 ， 把 数据 模型 提供 给 它 。 10. 泻 染 结果 返回 给 [响应 ] 组 件 。 11. 响应 组 件 发 送 泻 染 
结果 给 用 户 浏览 器 。 


第 一 个 程序 HelloWord - Yii2 教 程 


说 声 Hello 


本 章节 描述 了 如 何在 你 的 应用 中 创建 一 个 新 的 “Hello” 页面 。 为 了 做 到 这 点 ， 将 会 创建 一 个 [ 操 
作 ] 和 一 个 [视图 ] : 应 用 将 会 分 派 页 面 请 求 给 操作 操作 将 会 依次 泻 染 视图 呈现 “Hello” 给 最 终 用 
户 贯穿 整个 章节 ， 你 将 会 掌握 三 件 事 : 1. 如 何 创 建 一 个 [操作 ] 去 响应 请 求 ， 2. 如 何 创 建 一 个 
[视图 ] 去 构造 响应 内 容 ， 3. 以 及 一 个 应 用 如 何 分 派 请 求 给 [操作 ]。 


创建 操作 


为 了 说 “Hello”， 需 要 创建 一 个 say [操作 ]， 从 请 求 中 接收 ”message 参数 并 显示 给 最 终 用 
户 。 如 果 请 求 没有 提供 message 参数 ， 操 作 将 显示 默认 参数 “Hello"。 > 补充 : [操作 ] 是 最 终 
用 户 可 以 直接 访问 并 执行 的 对 象 。 操 作 被 组 织 在 [控制 器 ] 中 。 一 个 操作 的 执行 结果 就 是 最 终 用 
户 收 到 的 响应 内 容 。 操作 必须 声明 在 [控制 器 ] 中 。 为 了 简单 起 见 ， 你 可 以 直接 在 
SiteController 控制 器 里 声明 say 操作 。 这 个 控制 器 是 由 文件 


controllers/SiteController.php 定义 的 。 以 下 是 一 个 潜 作 的 声明 


<?php 

namespace app\controllers; 

use yii\web\Controller,; 

class SiteController extends Controller 


{ 
X70 其 它 代码 全 于 
public function actionSay($message = ' 你 好 ') 
return $this->render('say', ['message' => $message]); 
} 


在 上 述 sitecontroller 代码 中 ， say 操作 被 定义 为 actionsay 方法 。Yii 使 用 action 前 
缀 区 分 普通 方法 和 操作 。 action 前 级 后 面 的 名 称 被 映射 为 操作 的 ID。 涉及 到 给 操作 命名 

时 ， 你 应 该 理解 Yii 如 何 处 理 操作 ID。 操 作 ID 总 是 被 以 小 写 处 理 ， 如 果 一 个 操作 ID 由 多 个 
单词 组 成 ， 单 词 之 间 将 由 连 字 符 连 接 (如 create-comment )。 操 作 ID 映射 为 方法 名 时 移 除了 连 
字符 ， 将 每 个 单词 首 字 母 大 写 ， 并 加 上 action 前 级 。 例子 : 操作 ID create-comment 相当 
于 方法 名 actioncreatecomment 。 上 述 代 码 中 的 操作 方法 接受 一 个 参数 $message ， 它 的 默认 
值 是 “Hello”( 就 像 你 设置 PHP 中 其 它 函 数 或 方法 的 默认 值 一 样 )。 当 应 用 接收 到 请 求 并 确定 
由 say 操作 来 响应 请 求 时 ， 应 用 将 从 请 求 的 参数 中 寻找 对 应 值 传人 进来 。 换 句 话说 ， 如 果 请 
求 包含 一 个 message 参数 ， 它 的 值 是 “Goodybye” ， 操作 方法 中 的 $message 变量 也 将 被 填 
充 为 “Goodbye” 。 在 操作 方法 中 ， yii\web\Controller::render()|render() 被 用 来 泻 染 一 个 
名 为 say 的 视图 文件 。 message 参数 也 被 传人 视图 ， 这 样 就 可 以 在 里 面 使 用 。 操 作 方 法 会 
返回 泻 染 结果 。 结 果 会 被 应 用 接收 并 显示 给 最 终 用 户 的 浏览 器 (作为 整 页 HTML 的 一 部 分 )。 


创建 视图 


[视图 ] 是 你 用 来 生成 响应 内 容 的 脚本 。 为 了 说 “Hello"， 你 需要 创建 一 个 say 视图， 以便 显示 
从 操作 方法 中 传 来 的 _ message 参数 。 


<?php 

use yii\helpers\Html; 

?> 

<?= Html::encode($message) ?> 


say 视图 应 该 存 为 views/site/say.php 文件 。 当 一 个 操作 中 调用 了 
yii\web\Controller::render()|render() 方法 时 ， 它 将 会 按 views/ 控 制 器 TID/ 视图 名 ,php 路 径 
加 载 PHP 文件 。 注意 以 上 代码 ， message 参数 在 输出 之 前 被 
yii\helpers\Html;:encode()|HTML-encoded 方法 处 理 过 。 这 很 有 必要 ， 当 参数 来 自 于 最 终 用 户 
时 ， 参 数 中 可 能 隐 含 的 恶意 JavaScript 代码 会 导致 跨 站 脚本 (XSS) 攻 击 。 当然 了 ， 你 大 概 会 
在 say 视图 里 放 入 更 多 内 容 。 内 容 可 以 由 HTML 标签 ， 纯 文本 ， 苦 至 PHP 语句 组 成 。 实 际 
上 say 视图 就 是 一 个 由 yii\web\Controller::render()|render() 执行 的 PHP 上 脚本。 视图 脚 
本 输出 的 内 容 将 会 作为 响应 结果 返回 给 点 用。 占用 将 依次 输出 结果 给 最 终 用 户 。 


尝试 下 
创建 完 操作 和 视图 后 ， 你 就 可 以 通过 下 面 的 URL 访问 新 页 面 了 : 


http://hostname/index.php?r=site/say&message=Hello+world 


[Hello World] 这 个 URL 将 会 输出 包含 “Hello World” 的 页 面 ， 页 面 和 应 用 里 的 其 它 页 面 使 用 同 
样 的 头 部 和 尾部 。 如 果 你 省 略 URL 中 的 message 参数 ， 将 会 看 到 页 面 只 显示 “Hello"。 这 是 
因为 ”message 被 作为 一 个 参数 传 给 actionsay() 方法 ， 当 省 略 它 时 ， 参 数 将 使 用 默认 的 
“Hello” 代替 。 > 补充 : 新 页 面 和 其 它 页 面 使 用 同样 的 头 部 和 尾部 是 因为 
yii\web\Controller::render()|render() 方法 会 自动 把 say 视图 执行 的 结果 族人 入 称 为 [布局 ] 
的 文件 中 ， 本 例 中 是 views/layouts/main.php 。 上 面 URL 中 的 参数 r 需要 更 多 解释 。 它 代 
表 [ 路 由 ]， 是 整个 应 用 级 的 ， 指 向 特定 操作 的 独立 ID。 路 由 格式 是 控制 器 ID/ 操作 ID 。 应 用 接 
受 请 求 的 时 候 会 检查 参数 ， 使 用 控制 器 ID 去 确定 哪个 控制 器 应 该 被 用 来 义理 请 求 。 然 后 相应 
控制 器 将 使 用 操作 ID 去 确定 哪个 操作 方法 将 被 用 来 做 具体 工作 。 上 述 例子 中 ， 路 由 

site/say 将 被 解析 至 SiteController 控制 器 和 其 中 的 say 操 作 。 因 此 
SiteController::actionSay() 方法 将 被 调用 义理 请 求 。 > 补充 : : 与 操作 一 样 ， 一 1 应 用 中 控 
制 器 同样 有 唯一 的 ID。 控制 器 ID 和 操作 ID 使 用 同样 的 命名 规则 。 控 制 器 的 类 名 源 自 于 控制 
器 ID， 移 除了 连 字符 ， 每 个 单词 首 字 母 大 写 ， 并 加 上 controller 后 级 。 例 子 : 控制 器 ID 
post-comment 相当 于 控制 器 类 名 PostCommentController 。 


总 结 
通过 本 章节 你 接触 了 MVC 设计 模式 中 的 控制 器 和 视图 部 分 。 创 建 了 一 个 操作 作为 控制 器 的 一 
部 分 去 处 理 特定 请 求 。 然 后 又 创建 了 一 个 视图 去 构造 响应 内 容 。 在 这 个 小 例子 中 ， 没 有 模型 
调用 ， 唯 一 涉及 到 数据 的 地 方 是 _ message 参数 。 你 同样 学 习 了 Yii 路 由 的 相关 内 容 ， 它 是 用 
户 请 求 与 控制 器 操作 之 间 的 桥梁 。 下 一 章 ， 你 将 学 习 如 何 创建 一 个 模型 ， 以 及 添加 一 个 包含 


HTML 表单 的 页 面 。 


使 用 表单 - Yii2 教 程 
使 用 表单 


本 章节 将 介绍 如 何 创建 一 个 从 用 户 那 搜集 数据 的 表单 页 。 该 页 将 显示 一 个 包含 name 输入 框 
和 email 输入 框 的 表单 。 当 搜集 完 这 两 部 分 信息 后 ， 页 面 将 会 显示 用 户 输 入 的 信息 。 


为 了 实现 这 个 目标 ， 除 了 创建 一 个 [操作 ] 和 两 个 [视图 ] 外 ， 还 需要 创建 一 个 [模型 ]。 
贯穿 整个 小 节 ， 你 将 会 学 到 : 


。 创建 一 个 模型 代表 用 户 通过 表单 输入 的 数据 
。 声明 规则 去 验证 输入 的 数据 
。 在 视图 中 生成 一 个 HTML 表单 


创建 模型 


模型 类 EntryForm 代表 从 用 户 那 请 青 求 的 数据 ， 该 类 如 下 所 示 并 存储 在 models/EntryForm.php 
文件 中 。 请 参考 [类 自动 加 载 ] 章 节 获 取 更 多 关于 类 命名 约定 的 介绍 。 


<?php 

namespace appxmodels 

use yii\base\Model; 

class EntryForm extends Model 


{ 
public $name; 
public $email; 
public function rules() 
return [ 
~"'name', 'email'], 'required'], 
['email', 'email'] 
]; 
} 
} 


该 类 继承 自 yii\base\Model ，Yii 提供 的 一 个 基 类 ， 通 常用 来 表示 数据 。 


补充 : yii\base\Model 被 用 于 普通 模型 类 的 父 类 并 与 数据 表 无 
关 。 yii\db\ActiveRecord 通常 是 普通 模型 类 的 父 类 但 与 数据 表 有 关联 ( 译 者 
注 : yii\db\ActiveRecord 类 其 实 也 是 继承 自 yii\base\Model ， 增加 了 数据 库 库 处 理 )。 


EntryForm 类 包含 name 和 email 两 个 公共 成 员 ， 用 来 储存 用 户 输入 的 数据 。 它 还 包含 一 
个 名 为 rules() 的 方法 ， 用 来 返回 数据 验证 规则 的 集合 rg 


e name 和 email 值 都 是 必须 的 


。 mail 的 值 必 须 满足 email 地址 验证 


如 果 你 有 一 个 从 用 户 那 搜集 数据 的 EntryForm 对 象 ， 你 可 以 调用 它 的 
yii\base\Model: :validate()|validate() 方法 触发 数据 验证 。 如 果 有 数据 验证 失败 ， 将 把 
yii\base\Model: :hasErrors|hasErrors 属性 设 为 ture, 想 要 知道 具体 发 生 什么 错误 就 调用 


yii\base\Model::getErrors|getErrors 。 


<?php 
$model = new EntryForm(); 
$model->name = 'Qiang'; 
$model->email = 'bad'; 
if ($model->validate()) { 
// 验证 成 功 ! 
} else { 
// 失败 ! 


// 使 用 $model->getErrors() 获取 错误 详情 


创建 操作 


下 面 你 得 在 site 控制 器 中 创建 一 个 entry 操作 用 于 新 建 的 模型 。 操 作 的 创建 和 使 用 已 经 
在 说 一 声 你 好 小 节 中 解释 了 。 


<?php 

namespace app\controllers; 

WSeD Yi 

use yii\web\Controller,; 

use app\models\EntryForm; 

class SiteController extends Controller 


{ 
人 代 冯 过 本 
public function actionEntry() 
$model = new EntryForm; 
if ($model->load(Yii::$app->request->post()) && $model->validate()) { 
// 验证 $model 收 到 的 数据 
// 做 些 有 意义 的 事 ... 
return $this->render('entry-confirm', ['model' => $model]); 
} else { 
// 无 论 是 初始 化 显示 还 是 数据 验证 错误 
return $this->render('entry', ['model' => $model]); 
} 
} 
} 


该 操作 首先 创建 了 一 个 EntryForm 对 象 。 然 后 党 试 从 $_PosT 搜集 用 户 提交 的 数据 ， 由 Yii 
的 yii\web\Request::post() 方法 负 责 搜集 。 如 果 模 型 被 成 功 填充 数据 (也 就 是 说 用 户 已 经 提 
交 了 HTML 表单 )， 操 作 将 调用 _yii\base\Model: :validate()|validate() 去 确保 用 户 提交 的 是 
有 效 数据 。 


补充 : 表达 式 Yii::$app 代表 [应 用 ] 实 例 ， 它 是 一 个 全 局 可 访问 的 单 例 。 同 时 它 也 是 一 
个 [服务 定位 器 ]， 能 提供 request ， response ， db 等 等 特定 功能 的 组 件 。 在 上 面 的 代 
码 里 就 是 使 用 request 组 件 来 访问 应 用 实例 收 到 的 $_PosT 数据 。 


用 户 提交 表单 后 ， 操作 将 会 泻 染 一 个 名 为 entry-confirm 的 视图 去 确认 用 户 输 入 的 数据 。 如 
果 没 填 表单 就 提交 ， 或 数据 包含 错误 ( 译 者 : 如 email 格式 不 对 )， entry 视图 将 会 泻 染 输 
出 ， 连 同 表单 一 起 输出 的 还 有 验证 错误 的 详细 信息 。 


注意 : 在 这 个 简单 例子 里 我 们 只 是 呈现 了 有 效 数据 的 确认 页 面 。 实 践 中 你 应 该 考虑 使 用 
yii\web\controller:.refresh()|refresh() 或 
yii\web\Controller::redirect()|redirect() 去 避免 表单 重复 提交 问题 。 





创建 视图 
最 后 创建 两 个 视图 文件 entry-confirm 和 entry 。 他 们 会 被 刚才 创建 的 entry 操作 演 染 。 


entry-confirm 视图 简单 地 显示 提交 的 name 和 email 数据 。 视 图 文件 保存 在 


views/site/entry-confirm.php 。 


<?php 

use yii\helpers\Html; 

?> 

<p>You have entered the following information:</p> 


<ul> 
<l1i><label>Name</label>: <?= Html::encode($model->name) ?></1i> 
<l1i><label>Email</label>: <?= Html::encode($model->email) ?></1i> 
</ul> 


entry 视图 显示 一 个 HTML 表单 。 视 图 文件 保存 在 views/site/entry.php 。 


<?php 

use yii\helpers\Html; 

use yii\widgets\ActiveForm; 

?> 

<?php $form = ActiveForm: :begin(); ?> 
<?= $form->field($model, 'name') ?> 
<?= $form->field($model, 'email') ?> 
<div class="form-group"> 

<?= Html::submitButton('Submit', ['class' => 'btn btn-primary']) ?> 

</div> 

<?php ActiveForm: :end(); ?> 


视图 使 用 了 一 个 功能 强大 的 小 部 件 yii\widgets\ActiveForm|ActiveForm 去 生成 HTML 表单 。 
其 中 的 begin() 和 end() 分 别 用 来 泻 染 表 单 的 开始 和 关闭 标签 。 在 这 两 个 方法 之 间 使 用 了 
yii\widgets\ActiveForm: :field()|field() 方法 去 创建 输入 框 。 第 一 个 输入 框 用 于 “name”， 

第 二 个 输入 框 用 于 “email”。 之 后 使 用 yii\helpers\Html::submitButton() 方法 生成 提交 按 

钮 。 


尝试 上 下 
用 浏览 器 访问 下 面 的 URL 看 它 能 否 工 作 : 


http://hostname/index.php?r=site/entry 


你 会 看 到 一 个 包含 两 个 输入 框 的 表单 的 页 面 。 每 个 输入 框 的 前 面 都 有 一 个 标签 指明 应 该 输入 
的 数据 类 型 。 如 果 什 么 都 不 填 就 点 击 提交 按钮 ， 或 填 入 格式 不 正确 的 email 地 址 ， 将 会 看 到 
在 对 应 的 输入 框 下 显示 错误 信息 。 [验证 错误 的 表单 ] 输入 有 效 的 name 和 email 信息 并 提交 
后 ， 将 会 看 到 一 个 显示 你 所 提交 数据 的 确认 页 面 。 [输入 数据 的 确认 页 ] 


效果 说 明 


你 可 能 会 好 奇 HTML 表单 暗地里 是 如 何 工作 的 呢 ， 看 起 来 它 可 以 为 每 个 输入 框 显示 文字 标 
签 ， 而 当 你 没 输入 正确 的 信息 时 又 不 需要 刷新 页 面 就 能 给 出 错误 提示 ， 似 乎 有 些 神奇 。 


是 的 ， 其 实数 据 首先 由 客户 端 JavaScript 脚本 验证 ， 然 后 才 会 提交 给 服务 器 通过 PHP 验 
证 。 yii\widgets\ActiveForm 足够 智能 到 把 你 在 _ EntryForm 模型 中 声明 的 验证 规则 转化 成 客 
户 端 JavaScript 脚本 去 执行 验证 。 如 果 用 户 浏览 器 禁用 了 JavaScript， 服务 器 端 仍然 会 像 
actionEntry() 方法 里 这 样 验 证 一 通 数 据 。 这 保证 了 任何 情况 下 用 户 提 交 的 数据 都 是 有 效 
的 。 


警告 : 客户 端 验 证 是 提高 用 户 体验 的 手段 。 无 论 它 是 否 正 常 和 启用， 服务 端 验 证 则 都 是 必 
须 的 ， 请 不 要 忽略 它 。 


输入 框 的 文字 标签 是 _ field() 方法 生成 的 ， 内 容 就 是 模型 中 该 数据 的 属性 名 。 例 如 模型 中 的 
name 属性 生成 的 标签 就 是 Name 。 


你 可 以 在 视图 中 自 定义 标签 : 


<?= $form->field($model，'name' )->label(' 自 定义 Name' ) ?> 
<?= $form->field($model,，'email' )->label(' 自 定义 Email') ?> 


补充 : Yii 提供 了 相当 多 类 似 的 小 部 件 去 帮 你 生成 复杂 且 动 态 的 视图 。 在 后 面 你 还 会 了 解 
到 自己 写 小 部 件 是 多 么 简单 。 你 可 能 会 把 自己 的 很 多 视图 代码 转化 成 小 部 件 以 提高 
用 ， 加 快 开发 效率 。 
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本 章节 指南 中 你 接触 了 MVC 设计 模式 的 每 个 部 分 。 学 到 了 如 何 创 建 一 个 模型 代表 用 户 数据 并 
验证 它 的 有 效 性 。 


你 还 学 到 了 如 何 从 用 户 那 获取 数据 并 在 浏览 器 上 回 显 给 用 户 。 这 本 来 是 开发 应 用 的 过 程 中 比 
较 耗 时 的 任务 ， 好 在 Yii 提供 了 强大 的 小 部 件 让 它 变 得 如 此 简单 。 


下 一 章 你 将 学 习 如 何 使 用 数据 库 ， 几 乎 每 个 应 用 都 需要 数据 库 。 


Yii2 使 用 数据 库 - Yii2 教 程 
使 用 数据 库 


本 章节 将 介绍 如 何如 何 创 建 一 个 从 数据 表 country 中 获取 国家 数据 并 显示 出 来 的 页 面 。 为 了 
实现 这 个 目标 ， 你 将 会 配置 一 个 数据 库 连 接 ， 创 建 一 个 活动 记录 类 ， 并 且 创 建 一 个 操作 及 一 
个 视图 。 


贯穿 整个 章节 ， 你 将 会 学 到 : 


。 配置 一 个 数据 库 连 接 

。 定义 一 个 活动 记录 类 

。 使 用 活动 记录 从 数据 库 中 查询 数据 
。 以 分 页 方式 在 视图 中 显示 数据 


请 注意 ， 为 了 掌握 本 章 你 应 该 有 具 各 最 基本 的 数据 库 知 识 和 使 用 经 验 。 尤 其 是 应 该 知道 如 何 创 
建 数据 库 ， 如 何 通 过 数据 库 终端 执行 SQL 语句 。 


准备 数据 库 


首先 创建 一 个 名 为 yii2basic 的 数据 库 ， 应 用 将 从 这 个 数据 库 中 获取 数据 。 你 可 以 创建 
SQLite，MySQL，PostregSQL，MSSQL 或 Oracle 数据 库 ，Yii 内 置 多 种 数据 库 支 持 。 简单 
起 见 后 面 的 内 容 将 以 MySQL 为 例 做 演示 。 


然后 在 数据 库 中 创建 一 个 名 为 ”country 的 表 并 插入 简单 的 数据 。 可 以 执行 下 面 的 语句 : 


CREATE TABLE country (人 
“code CHAR(2) NOT NULL _ PRIMARY KEY, 
name CHAR(52) NOT NULL, 
‘population. INT(11) NOT NULL DEFAULT '0' 
) ENGINE=InnoDB DEFAULT CHARSET=utf8; 


INSERT INTO “Country ”VALUES ('AU'，'Australia' ,18886000 ) ; 
INSERT INTO ` Country ”VALUES ('BR','Brazil',170115000); 

INSERT INTO “Country ”VALUES ('CA','Canada',1147000); 

INSERT INTO “Country ”VALUES ('CN','China',1277558000); 

INSERT INTO ‘Country ”VALUES ('DE','Germany',82164700); 
INSERT INTO ‘Country ”VALUES ('FR','France',59225700); 

INSERT INTO ` Country ”VALUES ('GB', 'United Kingdom',59623400); 
INSERT INTO ` Country ”VALUES ('IN','India',1013662000); 

INSERT INTO ‘Country ”VALUES ('RU'，'Russia' ,146934000 ) ; 

INSERT INTO “` Country ”VALUES ('US', 'United States',278357000); 


于 是 便 有 了 一 个 名 为 yii2basic 的 数据 库 ， 在 这 个 数据 库 中 有 一 个 包含 三 个 字段 的 数据 表 
Country ， 表 中 有 十 行 数据 。 


配 讲 数据库 连 接 


开始 之 前 ， 请 确保 你 已 经 安装 了 PHP PDO 扩展 和 你 所 使 用 的 数据 库 的 PDO 驱动 (例如 
MySQL 的 pdo_mysql )。 对 于 使 用 关系 型 数据 库 来 讲 ， 这 是 基本 要 求 。 


驱动 和 扩展 安装 可 用 后 ， 打 开 config/db.php 修改 里 面 的 配置 参数 对 应 你 的 数据 库 配置 。 该 
文件 默认 包含 这 些 内 容 : 


<?php 
return [ 
'class' => 'yiidbConnection', 
'dsn' => 'mysql:host=localhost;dbname=yii2basic"', 
'UusSername' => 'root', 
"password' => "'", 
'charset' => 'utf8', 


config/db/php 是 一 个 典型 的 基于 文件 的 配置 工具 。 这 个 文件 配置 了 数据 库 连 接 
yiidbConnection 的 创建 和 初始 化 参数 ， 应 用 的 SQL 查询 正 是 基于 这 个 数据 库 。 


上 面 配置 的 数据 库 连 接 可 以 在 应 用 中 通过 Yii::$app-&gt;db 访问 。 


补充 : config/db.php 将 被 包含 在 应 用 配置 文件 config/web.php 中 ， 后 者 指定 了 整个 应 
用 如 何 初 始 化 。 请 参考 配置 章节 了 解 更 多 信息 。 


创建 活动 记录 


创建 一 个 继承 自 活 动 记录 类 的 类 country ， 把 它 放 在 models/country.php ， 去 表示 和 获取 
country 表 的 数据 。 


<?php 

namespace appmodels; 

use yiidbActiveRecord; 

class Country extends ActiveRecord 


{ 
} 


这 个 country 类 继承 自 yiidbActiveRecord 。 你 不 用 在 里 面 写 任何 代码 。 只 需要 像 现在 这 
样 ，Yii 就 能 根据 类 名 去 猜测 对 应 的 数据 表 名 。 


补充 : 如 果 类 名 和 数据 表 名 不 能 直接 对 应 ， 可 以 重 写 
yiidbActiveRecord::tableName()|tableName() 方法 去 显 式 指定 相关 表 名 。 


使 用 country 类 可 以 很 容易 地 操作 country 表 数 据 ， 就 像 这 段 代 码 : 


use appmodelsCountry; 


// 获取 country 表 的 所 有 行 并 以 name 排序 


$countries = Country::find()->orderBy('name')->all(); 


// 获取 主键 为 “US” 的 行 
$country = Country::findone('US'); 


// 输出 “United States” 
echo $country->name; 


// 修改 name 为 “U.S.A.” 并 在 数据 库 中 保存 更 改 
$country->name = 'U.S.A.'; 
$country->save( ); 


补充 : 活动 记录 是 面向 对 象 、 功 能 强大 的 访问 和 操 
记录 章节 了 解 更 多 信息 。 除 此 之 外 你 还 可 以 使 用 另 一 种 更 原生 的 称 做 数据 访问 对 象 的 方 


法 操作 数据 库 数 据 。 


创建 操作 


为 了 向 最 终 用 户 显示 国家 数据 ， 你 需要 创建 一 个 操作 。 相 比 之 前 小 节 掌 握 的 在 site 控制 器 
中 创建 操作 ， 在 这 里 为 所 有 和 国家 有 关 的 数据 新 建 一 
为 countrycontroller ， 并 在 其 中 创建 一 个 index 操作 ， 如 下 : 


<?php 
namespace appcontrollers 


use yiiwebController; 
use yiidatapagination; 
use appmodelsCountry; 


class CountryController extends Controller 


public function actionIndex() 


{ 
$query = Country::find(); 


$pagination = new Pagination([ 
'defaultPageSize' => 5, 
'totalCount' => $query->count(), 


]); 


$countries = $query->orderBy('name') 
->offset($pagination->offset) 
->limit($pagination->l1imit) 
->all( ); 


return $this->render('index', [ 
'countries' => $countries, 
'pagination' => $pagination, 


]); 


把 上 面 的 代码 保存 在 controllers/CountryController 


个 控制 器 更 加 合理 。 新 控制 器 名 


.php 。 


作 数 据 库 数据 的 方式 。 你 可 以 在 活动 


index 操作 调用 了 活动 记录 country: :find() 方法 ， 去 生成 查询 语句 并 从 country 表 中 取 
回 所 有 数据 。 为 了 限定 每 个 请 求 所 返回 的 国家 数量 ， 查 询 在 yiidatapagination 对 象 的 帮助 
下 进行 分 页 。 Pagination 对 象 的 使 命 主 要 有 两 点 : 


。 为 SQL 查询 语句 设置 offset 和 limit 从 句 ， 确 保 每 个 请 求 只 需 返 回 一 页 数据 (本 例 中 
每 页 是 5 行 )。 
。 在 视图 中 显示 一 个 由 页 码 列 表 组 成 的 分 页 器 ， 这 点 将 在 后 面 的 段落 中 解释 。 


逆 


在 代码 末尾 ， index 操作 泻 染 一 个 名 为 index 的 视图 ， 并 传递 国家 数据 和 分 页 信息 进去 。 


创建 视图 


在 views 目录 下 先 创 建 一 个 名 为 country 的 子 目 录 。 这 个 目录 存储 所 有 由 country 控制 器 
泻 染 的 视图 。 在 views/country 目录 下 创建 一 个 名 为 index.php 的 视图 文件 ， 内 容 如 下 : 


<?php 
use yiihelpersHtml; 
use yiiwidgetsLinkPager; 
?> 
<h1i>Countries</h1> 
<ul> 
<?php foreach ($countries as $country): ?> 
<]1i> 
<?= Html::encode("{$country->name} ({$country->code})") ?>: 
<?= $country->population ?> 
</1i> 
<?php endforeach; ?> 
</ul> 


<?= LinkPager::widget(['pagination' => $pagination]) ?> 


这 个 视图 包含 两 部 分 用 以 显示 国家 数据 。 第 一 部 分 通 历 国家 数据 并 以 无 序 HTML 列表 泻 染 出 
来 。 第 二 部 分 使 用 yiiwidgetsLinkPager 去 泻 染 从 操 作 中 传 来 的 分 页 信息 。 小 部 件 LinkPager 
显示 一 个 分 页 按钮 的 列表 。 点 击 任何 一 个 按钮 都 会 跳 转 到 对 应 的 分 页 。 


尝试 下 
浏览 器 访问 下 面 的 URL 看 看 能 否 工 作 : 


http://hostname/index.php?r=country/index 


首先 你 会 看 到 显示 着 五 个 国家 的 列表 页 面 。 在 国家 下 面 ， 你 还 会 看 到 一 个 包含 四 个 按钮 的 分 
页 器 。 如 果 你 点 击 按钮 “2"， 将 会 跳 转 到 显示 另外 五 个 国家 的 页 面 ， 也 就 是 第 二 页 记录 。 如 果 
观察 仔细 点 你 还 会 看 到 浏览 器 的 URL 变 成 了 : 


http://hostname/index.php?r=country/index&page=2 


在 这 个 场 景 里 ， yiidataPpagination|Pagination 提供 了 为 数据 结果 集 分 页 的 所 有 功能 。 


。 首先 yiidatapagination|Pagination 把 SELECT 的 子 查询 LIMIT 5 OFFSET 9 数据 表示 
成 第 一 页 。 因 此 开头 的 五 条 数据 会 被 取出 并 显示 。 

e 然后 小 部 件 yiiwidgetsLinkPager|LinkPager 使 用 
yiIiidataPagination: :createUr1l()|Pagination: :createUrl() 方法 生成 的 URL 去 泻 染 翻 页 
按钮 。URL 中 包含 必要 的 参数 page 才能 查询 不 同 的 页 面 编号 。 

。 如 果 你 点 击 按钮 “2"， 将 会 发 起 一 个 路 由 为 country/index 的 新 请 
求 。 yiidatapagination|Pagination 接收 到 URL 中 的 page 参数 把 当前 的 页 码 设 为 2。 
新 的 数据 库 请 求 将 会 以 LIMIT 5 oFFSET 5 查询 并 显示 。 
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本 章节 中 你 学 到 了 如 何 使 用 数据 库 。 你 还 学 到 了 如 何 取出 并 使 用 yiidatapagination 和 
yiiwidgetsLinkPager 显示 数据 。 

下 一 章 中 你 会 学 到 如 何 使 用 Yii 中 强大 的 代码 生成 器 Gii， 去 帮助 你 实现 一 些 常用 的 功能 需 
求 ， 例 如 增 查 改 删 (CRUD) 数 据 表 中 的 数据 。 事 实 上 你 之 前 所 写 的 代码 全 部 都 可 以 由 Gii 自动 
生成 。 


使 用 Gii 生 成 代码 - Yii2 教 程 
使 用 Gii 生成 代码 


本 章节 将 介绍 如 何 使 用 Gii 去 自动 生成 Web 站 点 常用 功能 的 代码 。 使 用 Gii 生成 代码 非常 简 
单 ， 只 要 按照 Gii 页 面 上 的 介绍 输入 正确 的 信息 即 可 。 


本 章节 ， 你 将 会 学 到 : 


测 
站 


。 在 你 的 上 应 用 中 开启 Gii 

。 使 用 Gii 去 生成 活动 记录 类 

。 使 用 Gii 去 生成 数据 表 操 作 的 增 查 改 删 (CRUD) 代 码 
。 自 定义 Gii 生成 的 代码 


开始 Gii 
Gii 是 Yii 中 的 一 个 模块 。 可 以 通过 配置 应 用 的 yiiaseApplication::modules|modules 属性 开启 
它 。 通 常 来 讲 在 config/web.php 文件 中 会 有 以 下 配置 代码 : 
$config = [ ... ]; 
if (YII_ENV_DEV) { 
$config['bootstrap'][] = 'gii'; 
$config['modules']['gii'] = 'yiigiiModule'; 
这 段 配置 的 意思 是 如 果 当 前 是 开发 环境 ， 应 用 会 包含 gii 模块 ， 模 块 类 是 yiigiiModule 。 


如 果 你 检查 应 用 的 入 口 脚本 web/index.php ， 将 看 到 这 行 代 码 将 YII_ENV_DEV 设 为 true : 


defined('YII_ENV') or define('YII_ENV', 'dev'); 


代码 设置 应 用 处 于 开发 模式 下 ， 按 照 上 面 的 配置 会 打开 Gii 模块 。 你 可 以 直接 通过 URL 访问 
Gii : 


http://hostname/index.php?r=gii 


生成 活动 记录 类 


选择 “Model Generator (点 击 Gii 首页 的 链接 ) 去 生成 活动 记录 类 。 并 像 这 样 填写 表单 : 


e Table Name: country 
e Model Class: Country 


然后 点 击 “Preview” 按钮 。 你 会 看 到 models/country.php 被 列 在 将 要 生成 的 文件 列表 中 。 可 
以 点 击 文件 名 预览 内 容 。 


如 果 你 已 经 创建 过 同样 的 文件 ， 使 用 Gii 可 以 必 写 它 ， 点 击 文件 名 旁边 的 diff 能 查看 现 有 
文件 与 将 要 生成 的 文件 的 内 容 区 别 。 


想 要 履 写 已 存在 文件 ， 选 中 “overwrite” 下 的 复 选 框 然 后 点 击 “Generator。 如 果 是 新 文件 ， 只 
点 击 “Generator 就 好 。 


接 下 来 你 会 看 到 一 个 包含 已 生成 文件 的 说 明 页 面 。 如 果 生 成 过 程 中 履 写 过 文件 ， 还 会 有 一 条 
信息 说 明代 码 是 重新 生成 覆盖 的 。 


生成 CRUD 代码 


CRUD 代表 增 ， 查 ， 改 ， 删 操作 ， 这 是 绝 大 多 数 Web 站 点 常用 的 数据 处 理 方式 。 选 择 Gii 中 
的 “CRUD Generator (点 击 Gii 首页 的 链接 ) 去 创建 CRUD 功能 。 之 前 的 “country" 例子 需要 
像 这 样 填写 表单 : 


e。 Model Class: appmodelsCountry 
。 Search Model Class: appmodelsCountrySearch 
e Controller Class: appcontrollersCountryController 


然后 点 击 “Preview” 按钮 。 你 会 看 到 下 述 将 要 生成 的 文件 列表 。 


NEED THE IMAGE HERE / 等 待 官方 补充 图 片 


如 果 你 之 前 创建 过 controllers/countrycontroller.php 和 views/country/index.php 文件 (在 
指南 的 使 用 数据 库 小 节 )， 选 中 “overwrite” 下 的 复 选 框 覆 写 它们 (之 前 的 文件 没 能 全 部 支持 
CRUD)。 


尝试 下 


用 浏览 器 访问 下 面 的 URL 查看 生成 代码 的 运行 : 


http://hostname/index.php?r=country/index 


可 以 看 到 一 个 栅 格 显示 着 从 数据 表 中 获取 的 国家 数据 。 支 持 在 列 头 对 数据 进行 排序 ， 输 入 和 
选 条 件 进 行 第 选 。 


可 以 浏览 详情 ， 编 辑 ， 或 删除 栅 格 中 的 每 个 国家 。 还 可 以 点 击 栅 格 上 方 的 “Create Country” 
按钮 通过 表单 创建 新 国家 。 


下 面 列 出 由 Gii 生成 的 文件 ， 以 便 你 研习 功能 和 实现 ， 或 修改 它们 。 


。 控制 器 : controllers/CountryController.php 
。 模型 : models/Country.php 和 models/CountrySearch.php 
e 视图 : views/country/*.php 





补充 : Gii 被 设计 成 高 度 可 定制 和 可 扩展 的 代码 生成 工具 。 使 用 它 可 以 大 幅 提 高 应 用 开发 
速度 。 请 参考 Gii 小 节 了 解 更 多 内 容 。 














总 疆 


AAA 一 器 


本 章 学 习 了 如 何 使 用 Gii 去 生成 为 数据 表 中 数据 实现 完整 CRUD 功能 的 代码 。 


组 件 (Component) - Yii2 教 程 


组 件 (Component) 


组 件 是 Yii 应 用 的 主要 基石 。 是 yiiasecomponent 类 或 其 子 类 的 实例 。 三 个 用 以 区 分 它 和 其 它 
类 的 主要 功能 


。 属性 (Property) 
。 事件 (Event) 
。 行为 (Behavior) 


或 单独 使 用 ， 或 彼此 配合 ， 这 些 功 能 的 应 用 让 Yii 的 类 变 得 更 加 灵活 和 易 用 。 以 小 部 件 
yiijuiDatePicker | 日 期 选择 器 来 举例 ， 这 是 个 方便 你 在 视图 中 生成 一 个 交互 式 日 期 选择 器 的 
UI 组件: 


1. use yiijuiDatePicker ， 


echo DatePicker: :widget([ 
'language' =&gt; "zh-CN'， 
'name' =&gt; "country '， 
"clientoptions' =&gt; [ 
"dateFormat ' =&gt; "yy-mm-dd '， 


OOO 


中 
D> 


这 个 小 部 件 继承 自 yiiasecomponent ， 它 的 各 项 属性 改写 起 来 会 很 容易 。 


正 是 因为 组 件 功能 的 强大 ， 他 们 比 常规 的 对 象 (Object) 稍 微 重量 级 一 点 ， 因 为 他 们 要 使 用 额外 
的 内 存 和 CPU 时 间 来 处 理 事件 和 行为 。 如 果 你 不 需要 这 两 项 功能 ， 可 以 继承 
yiiaseobject 而 不 是 yiiasecomponent 。 这 样 组 件 可 以 像 普 通 PHP 对 象 一 样 高 效 ， 同 时 还 
支持 属性 (Property) 功 能 。 


当 继 承 yiiasecomponent 或 yiiaseobject 时 ， 推 荐 你 使 用 如 下 的 编码 风格 : 


。 若 你 需要 重 写 构造 方法 (Constructor)， 传 入 $config 作为 构造 器 方法 最 后 一 个 参数 ， 然 后 
把 它 传 递 给 父 类 的 构造 方法 。 

。 永远 在 你 重 写 的 构造 方法 结尾 处 调用 一 下 父 类 的 构造 方法 。 

如 果 你 重 写 了 yiiaseobject::init() 方法 ， 请 确保 你 在 init 方法 的 开头 处 调用 了 父 类 的 

init 方法 。 


例子 如 下 : 


AOPRODNDP 


namespace yiicomponentsMyClass; 
use yiiaseObject,; 


class MyClass extends Object 
{ 

public $propi1; 

public $prop2; 


public function __construct($parami, $param2, $config = [1]) 
> .. ， 配置 生效 前 的 初始 化 过 程 

parent::__construct($config); 

} 

public function init() 

parent: :init(); 

// ..， 配置 生效 后 的 初始 化 过 程 

) 


， 为 了 让 组 件 可 以 在 创建 实例 时 能 被 正确 配置 ， 请 遵照 以 下 操作 流程 : 


$component = new MyClass(1，2，[ prop1' =&gt; 3, 'prop2' =&gt; 4]) 
J 

$component = Yii::createObject([ 

'class' =&gt; MyClass::className(), 

'prop1' =&gt; 3, 

'prop2' =&gt; 4, 

], [1, 2]); 








补充 : 民 管 调用 Yii::createObject() 的 方法 看 起 来 更 加 复杂 ， 但 这 主要 因为 它 更 加 灵 
活 强 大 ， 它 是 基于 依赖 注入 容器 实现 的 。 





yiiaseobject 类 执行 时 的 生命 周期 如 下 : 


1， 构 造 方法 内 的 预 初 始 化 过 程 。 你 可 以 在 这 儿 给 各 属性 设置 缺 省 值 。 


4. 


通过 $config 配置 对 象 。 配 置 的 过 程 可 能 会 覆盖 掉 先 前 在 构造 方法 内 设置 的 默认 值 。 

在 yiiaseobject::init()|init() 方法 内 进行 初始 化 后 的 收尾 工作 。 你 可 以 通过 重 写 此 方 
法 ， 进 行 一 些 良 品 检验 ， 属 性 的 初始 化 之 类 的 工作 。 

对 象 方法 调用 。 


前 三 步 都 是 在 对 象 的 构造 方法 内 发 生 的 。 这 意味 着 一 旦 你 获得 了 一 个 对 象 实例 ， 那 么 它 就 已 
经 初始 化 就 绪 可 供 使 用 。 


属性 (Property) - Yii2 教 程 


属性 (Property) 


在 PHP 中， 类 的 成 员 变 量 也 被 称 为 属性 (properties)。 它 们 是 类 定义 的 一 部 分 ， 用 来 表现 一 
个 实例 的 状态 (也 就 是 区 分 类 的 不 同 实例 )。 在 具体 实践 中 ， 常 常会 想 用 一 个 稍微 特殊 些 的 方法 
实现 属性 的 读 写 。 例 如 ， 要 对 label 属性 执行 trim 操作 ， 可 以 用 以 下 代码 实现 : 


1. S$object-&gt;label = trim($label); 


上 述 代码 的 缺点 是 只 要 修改 label 属性 就 必须 再 次 调用 trim() 加 数 。 若 将 来 需要 用 其 它 方 
式 义理 lapel 属性 ， 上 比如 首 字母 大 写 ， 就 不 得 不 修改 所 有 给 label 属性 赋值 的 代码 。 这 种 
代码 的 重复 会 导致 bug， 这 种 实践 显然 需要 尽 可 能 避免 。 


为 解决 该 问题 ，Yii 引入 了 一 个 名 为 yii\base\object 的 基 类 ， 它 支持 基于 类 内 的 getter 和 
setter( 读 取 器 和 设 定 器 ) 方 法 来 定义 属性 。 如 果 某 类 需要 支持 这 个 特性 ， 只 需要 继承 
yii\base\0bject 或 其 子 类 即 可 。 





补充 : 几乎 每 个 Yii 框架 的 核心 类 都 继承 自 yii\base\object 或 其 子 类 。 这 意味 着 只 要 
在 核心 类 中 见 到 getter 或 setter 方法 ， 就 可 以 像 调用 属性 一 样 调用 它 。 





getter 方法 是 名 称 以 get 开头 的 方法 ， 而 setter 方法 名 以 set 开头。 方法 名 中 get 或 
set 后 面 的 部 分 就 定义 了 该 属性 的 名 字 。 如 下 面 代 码 所 示 ，getter 方法 getLabel() 和 
setter 方法 setLabel() 操作 的 是 label 属性 ， : 


1. namespace app\\components; 
3. Use yii\\base\\0bject; 

5. Cclass Foo extend Object 

到 a $_label; 


9. public function getLabel() 


10. { 

11. return $this-&gt;_label; 

12. 

14. public function setLabel($value) 
15. { 

16. $this-&gt;_label = trim($value); 
I 

18. } 


(详细 解释 : getter 和 setter 方法 创建 了 一 个 名 为 label 的 属性 ， 在 这 个 例子 里 ， 它 指向 一 个 
私有 的 内 部 属性 _1abel 。) 


getter/setter 定义 的 属性 用 法 与 类 成 员 变 量 一 样 。 两 者 主要 的 区 别 是 : 当 这 种 属性 被 读 取 时 ， 
对 应 的 getter 方法 将 被 调用 ; 而 当 属 性 被 赋值 时 ， 对 应 的 setter 方法 就 调用 。 如 : 


1. // 等 效 于 $label = $object-&gt;getLabel(); 
2. $label = $object-&gt;1label; 


Op 


// 等 效 于 $object-&gt;setLabel('abc'); 
$object-&gt;label = "abc'; 


只 定义 了 getter 没有 setter 的 属性 是 只 读 属性 。 党 试 赋值 给 这 样 的 属性 将 导致 
yii\base\InvalidcallException|InvalidcallException (无 效 调用 ) 异 常 。 类 似 的 ， 只 有 setter 
方法 而 没有 getter 方法 定义 的 属性 是 只 写 属性 ， 尝 试 读 取 这 种 属性 也 会 触发 异常 。 使 用 只 写 
属性 的 情况 几乎 没有 。 


通过 getter 和 setter 定义 的 属性 也 有 一 些 特殊 规则 和 限制 : 


。 这 类 属性 的 名 字 是 不 区 分 大 小 写 的 。 如 ，$object->label 和 $object->Label 是 同一 个 属 

性 。 因 为 PHP 方法 名 是 不 区 分 大 小 写 的 。 

如 果 此 类 属性 名 和 类 成 员 变 量 相同 ， 以 后 者 为 准 。 例 如 ， 假 设 以 上 Foo 类 有 个 label 成 

员 变 量 ， 然 后 给 $objectr->label = 'abc' 赋值 ， 将 赋 给 成 员 变 量 而 不 是 setter setLabel() 方 

法 。 

这 类 属性 不 支持 可 见 性 (访问 限制 )。 定 义 属 性 的 getter 和 setter 方法 是 public、protected 

还 是 private 对 属性 的 可 见 性 没有 任何 影响 。 

。 这 类 属性 的 getter 和 setter 方法 只 能 定义 为 非 静 态 的 ， 若 定义 为 静态 方法 (static) 则 不 会 
以 相同 方式 处 理 。 


回 到 开头 提 到 的 问题 ， 与 其 处 处 要 调用 trim() 男 数 ， 现 在 我 们 只 需 在 setter setLabel() 方 
法 内 调用 一 次 。 如 果 label 首 字母 变 成 大 写 的 新 要 求 来 了 ， 我 们 只 需要 修改 setLabel() 方 
法 ， 而 无 须 接触 任何 其 它 代 码 。 
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事件 


事件 可 以 将 自 定义 代码 “注入 ”到 现 有 代码 中 的 特定 执行 点 。 附 加 自 定义 代码 到 某 个 事件 ， 当 这 
个 事件 被 触发 时 ， 这 些 代码 就 会 自动 执行 。 例 如 ， 邮 件 程序 对 象 成 功 发 出 消息 时 可 触发 
messagesent 事件 。 如 想 追 踪 成 功 发 送 的 消息 ， 可 以 附加 相应 追踪 代码 到 messagesent 事 
件 。 

Yii 引 入 了 名 为 yii\base\Ccomponent 的 基 类 以 支持 事件 。 如 果 一 个 类 需要 触发 事件 就 应 该 继承 


yii\base\Component 或 其 子 类 。 


事件 处 理 器 (Event Handlers) 


事件 处 理 器 是 一 个 PHP 回调 函数 ， 当 它 所 附加 到 的 事件 被 触发 时 它 就 会 执行 。 可 以 使 用 以 下 
回调 本 数 之 一 : 

。 字符 串 形 式 指定 的 PHP 全 局 琅 数 ， 如 'trim' ; 

。 对 象 名 和 方法 名 数组 形式 指定 的 对 象 方 法 ， 如 [$object, $method] ; 

。 类 名 和 方法 名 数组 形式 指定 的 静态 类 方法 ， 如 [$class, $method] ; 

。 匿名 函数 ， 如 function ($event) { ... } 。 


事件 处 理 器 的 格式 是 : 


1. function ($event) { 
2. // $event 是 yii\\base\\Event 或 其 子 类 的 对 象 


co 


通过 ”$event 参数 ， 事 件 处 理 器 就 获得 了 以 下 有 关 事 件 的 信息 : 


@ yii\base\Event::name|event name : 事件 名 
e yii\base\Event::sender|event sender : 调用 trigger() 方法 的 对 象 
e yii\base\Event::datalcustom data : 附加 事件 处 理 器 时 传人 的 数据 ， 默 认为 空 ， 后 文 详 


述 


附加 事件 处 理 器 


调用 yii\base\Component::on() 方法 来 附加 人 处理 器 到 事件 上 。 如 : 


1. $foo = new Foo; 


3. // 义 理 器 是 全 局 函数 
4. $foo-&gt;on(Foo: :EVENT_HELLO， 'function_name ' ) ; 


6. // 处 理 器 是 对 象 方法 
7. $foo-&gt;on(Foo::EVENT_ HELLO, [$object, 'methodName']); 


9. // 处 理 器 是 静态 类 方法 
10,. $foo-&gt;on(Foo::EVENT_HELLO, ['app\\components\\Bar', 'methodName']); 


12. // 处 理 器 是 匿名 函数 

13., $foo-&gt;on(Foo::EVENT_HELLO, function ($event) { 
14. // 事 件 处理 逻 辑 

15. }); 


附加 事件 处 理 器 时 可 以 提供 额外 数据 作为 yii\base\Component: :on() 方法 的 第 三 个 参数 。 数 
据 在 事件 被 触发 和 义理 器 被 调用 时 能 被 处 理 器 使 用 。 如 : 


// 当 事 件 被 触发 时 以 下 代码 显示 "abc" 

// 因为 $event-&gt;data 包括 被 传递 到 "on'" 方法 的 数据 
$foo-&gt;on(Foo: :EVENT_HELLO, function ($event) { 
echo $event-&gt;data; 

}, 'abc'); 


ORODP 


时 间 义 理 器 顺序 


可 以 附加 一 个 或 多 个 处 理 器 到 一 个 事件 。 当 事件 被 触发 ， 已 附加 的 处 理 器 将 按 附加 次 序 依次 
调用 。 如 果 某 个 义理 器 需要 停止 其 后 的 义理 器 调用 ， 可 以 设置 $event 参数 的 
yii\base\Event::handled 属性 为 真 ， 如 下 : 


1. $foo-&gt;on(Foo::EVENT_HELLO, function ($event) { 
2. $event-&gt;handled = true; 
3. 了) 


默认 新 附加 的 事件 处 理 器 排 在 已 存在 处 理 器 队列 的 最 后 。 因 此 ， 这 个 处 理 器 将 在 事件 被 触发 
时 最 后 一 个 调用 。 在 处 理 器 队列 最 前 面 插 入 新 处 理 器 将 使 该 处 理 器 最 先 调 用 ， 可 以 传递 第 四 
个 参数 $append 为 假 并 调用 yii\base\Component: :on() 方法 实现 : 


“php $foo->on(Foo::EVENT_HELLO, function ($event) { // 这 个 处 理 器 将 被 插入 到 处 理 器 队 
列 的 第 一 位 ... }, $data, false); 


触发 事件 


事件 通过 调用 `yii\base\Component::trigger()” 方 法 触发 ， 此 方法 须 传递 ** 事 件 名 **， 还 可 以 传递 一 个 事件 对 


php 
namespace app\components; 


Use yii\base\Component; 
use yii\base\Event; 


class Foo extends Component 


{ 
const EVENT_HELLO = 'hello'; 
public function bar() 
$this->trigger(self::EVENT_HELLO); 
} 
} 





以 上 代码 当 调 用 bar() ， 它 将 触发 名 为 hello 的 事件 。 


提示 : 推荐 使 用 类 常量 来 表示 事件 名 。 上 例 中 ， 常 量 EvENT_HELLO 用 来 表示 hello 。 
这 有 两 个 好 处 。 第 一 ， 它 可 以 防止 拼写 错误 并 支持 IDE 的 自动 完成 。 第 二 ， 只 要 简单 检 
查 常 量 声 明 就 能 了 解 一 个 类 支持 哪些 事件 。 











有 时 想 要 在 触发 事件 时 同时 传递 一 些 额 外 信息 到 事件 处 理 器 。 例 如 ， 邮 件 程序 要 传递 消息 信 
息 到 messageSent 事件 的 处理 器 以 便 处 理 器 了 解 哪些 消息 被 发 送 了 。 为 此 ， 可 以 提供 一 个 事 
件 对 象 作 为 yii\base\component::trigger() 方法 的 第 二 个 参数 。 这 个 事件 对 象 必须 是 
yii\base\Event 类 或 其 子 类 的 实例 。 如 : 


1. namespace app\\components,; 


3. use yii\\base\\Component; 
4. Use yii\\base\\Event,; 


class MessageEvent extends Event 


6 
7 和 
8. public $message 
9. } 


11. class Mailer extends Component 
{ 
13,. const EVENT_MESSAGE_SENT = 'messageSent'; 
15. public function send($message ) 
{ 
17. // .. .发送 $message 的 逻辑 ... 
19. $event = new MessageEvent; 
20. $event-&gt;message = $message; 
21. $this-&gt;trigger(self::EVENT_MESSAGE_SENT, $event); 


22 
220 


当 yii\base\Component::trigger() 方法 被 调用 时 ， 它 将 调用 所 有 附加 到 命名 事件 (trigger 方法 
第 一 个 参数 ) 的 事件 处 理 器 。 


移 除 事件 义理 器 
从 事件 移 除 处 理 器 ， 调用 yii\base\Component: :off() 方法 。 如 : 


1. // 义理 器 是 全 局 画 数 
2. $foo-&gt;off(Foo::EVENT_HELLO, 'function_name ' ) ， 


4. // 义理 器 是 对 象 方法 
5. $foo-&gt;off(Foo::EVENT_HELLO, [$object, "methodName ' ] ) ; 


7. // 处 理 器 是 静态 类 方法 
8. $foo-&gt;off(Foo::EVENT_HELLO, ['app\\components\\Bar', 'methodName']); 


10. // 处 理 器 是 匿名 函数 
11. $foo-&gt;off(Foo::EVENT_HELLO, $anonymousFunction); 


注意 当 匿 名 加 数 附 加 到 事件 后 一 般 不 要 尝试 移 除 匿名 辑 数 ， 除 非 你 在 某 处 存储 了 它 。 以 上 示 
例 中 ， 假 设 匿名 画 数 存储 为 变量 $anonymousFunction 。 


移 除 事件 的 全 部 处 理 器 ， 简 单调 用 yii\base\Ccomponent::off() 即 可 ， 不 需要 第 二 个 参数 : 


1. $foo-&gt;off(Foo::EVENT_ HELLO); 


类 级 别 的 事件 处 理 器 


以 上 部 分 ， 我 们 叙述 了 在 实例 级 别 如 何 附 加 处 理 器 到 事件 。 有 时 想 要 一 个 类 的 所 有 实例 而 不 
是 一 个 指定 的 实例 都 响应 一 个 被 触发 的 事件 ， 并 不 是 一 个 个 附加 事件 处 理 器 到 每 个 实例 ， 而 
是 通过 调用 静态 方法 yii\base\Event::on() 在 类 级 别 附 加 处 理 器 。 


例如 ， 活 动 记录 对 象 要 在 每 次 往 数据 库 新 增 一 条 新 记录 时 触发 一 
yii\base\ActiveRecord::EVENT_AFTER_INSERT 事件 。 要 追踪 每 个 活动 记录 对 象 的 新 增 记 录 完 成 
情况 ， 应 如 下 写 代 码 : 。 


1. Use Yii; 
2. Use yii\\base\\Event,; 
3. Use yii\\db\\ActiveRecord; 


5. Event::on(ActiveRecord::className(), ActiveRecord::EVENT AFTER_ INSERT, function ($eve 
6. Yii::trace(get_ class($event-&gt;sender) . ' is inserted'); 


7. }); 





每 当 yii\base\ActiveRecord|ActiveRecord 或 其 子 类 的 实例 触发 
yii\base\ActiveRecord::EVENT_AFTER_INSERT|EVENT_AFTER_INSERT 事件 时 ， 这 个 事件 处 理 器 都 


会 执行 。 在 这 个 义理 器 中 ， 可 以 通过 $event-&gt;sender 获取 触发 事件 的 对 象 。 
当 对 象 触 发 事件 时 ， 它 首先 调用 实例 级 别 的 处 理 器 ， 然 后 才 会 调用 类 级 别处 理 器 。 


可 调用 静态 方法 yii\base\Event::trigger() 来 触发 一 个 类 级 别 事件 。 类 级 别 事件 不 与 特定 对 
象 相关 联 。 因 此 ， 它 只 会 引起 类 级 别 事 件 义理 器 的 调用 。 如 : 


1. Use yii\\base\\Event; 


Event::on(Foo::className(), Foo::EVENT_HELLO, function ($event) { 
echo $event-&gt;sender; // 显示 "app\\models\\Foo" 
}); 


7. Event::trigger(Foo::className(), Foo::EVENT_HELLO); 


ORO 


注意 这 种 情况 下 $event-&gt;sender 指向 触发 事件 的 类 名 而 不 是 对 象 实例 。 














注意 : 因为 类 级 别 的 义理 器 响应 类 和 其 子 类 的 所 有 实例 触发 的 事件 ， 必 须 齐 愤 使 用 ， 尤 
其 是 底层 的 基 类 ， 如 yii\base\0bject 。 





移 除 类 别 的 事件 处 理 器 只 需 调 用 yii\base\Event::off(),， 如 : 


1. // 移 除 $handler 
2. Event::off(Foo::className(), Foo::EVENT_ HELLO, $handler); 


// 移 除 Foo: :EVENT_HELLO 事件 的 全 部 处 理 器 
Event::off(Foo::className(), Foo::EVENT_HELLO); 


Op 


全 局 事件 


所 谓 全 局 事件 实际 上 是 一 个 基于 以 上 叙述 的 事件 机 制 的 戏法 。 一 个 全 局 可 访问 的 单 
例 ， 如 应 用 实例 。 


事件 触发 者 不 调用 其 自身 的 trigger() 方法 ， 而 是 调用 单 例 的 trigger() 方法 来 触发 全 局 
事件 。 类 似 地 ， 事 件 处 理 器 被 附加 到 单 例 的 事件 。 如 : 


1. Use Yii; 
2. Use yii\\base\\Event; 
3. Use app\\components\\Foo; 


5. Yii::$app-&gt;on('bar', function ($event) { 
6. echo get class($event-&gt;sender); // 显示 "app\\components\\Foo" 
7. 7}); 


9. Yii::$app-&gt;trigger('bar', new Event(['sender' =&gt; new Fool])); 


全 局 事件 的 一 个 好 处 是 当 附加 处 理 器 到 一 个 对 象 要 触发 的 事件 时 ， 不 需要 产生 该 对 象 。 相 
反 ， 人 处理 器 附加 和 事件 触发 都 通过 单 例 ( 如 应 用 实例 ) 完 成 。 


然而 ， 因 为 全 局 事件 的 命名 空间 由 各 方 共 享 ， 应 合理 命名 全 局 事件 ， 如 引入 一 些 命名 空间 


( 例 : "frontend.mail.sent", "backend.mail.sent")。 
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行为 


行为 是 yii\base\Behavior 或 其 子 类 的 实例 。 行 为 ， 也 称 为 mixins， 可 以 无 须 改 变 类 继承 关 
系 即 可 增强 一 个 已 有 的 yii\base\Component | 组件 类 功能 。 当 行为 附加 到 组 件 后 ， 它 将 “ 注 
入 " 它 的 方法 和 属性 到 组 件 ， 然 后 可 以 像 访问 组 件 内 定义 的 方法 和 属性 一 样 访问 它们 。 此 外 ， 
行为 通过 组 件 能 响应 被 触发 的 事件 ， 从 而 自 定 义 或 调整 组 件 正 常 执行 的 代码 。 


定义 行为 


要 定义 行为 ， 通 过 继承 yii\base\Behavior 或 其 子 类 来 建立 一 个 类 。 如 : 


namespace app\\components,; 


Use yii\\base\\Model; 
use yii\\base\\Behavior; 


class MyBehavior extends Behavior 
es $propl1; 

private $_prop2; 

public function getProp2() 


return $this-&gt;_prop2; 
} 


public function setProp2($value) 


{ 
$this-&gt;_prop2 = $value; 
} 


public function foo() 


{ 
A 
} 
} 


以 上 代码 定义 了 行为 类 app\components\MyBehavior 并 为 要 附加 行为 的 组 件 提 供 了 两 个 属性 


prop1 、 


提示 : 在 行为 内 部 可 以 通过 yii\base\Behavior: :owner 


处 理事 件 


三 | 
人 下 





耳 


prop2 和 一 个 方法 foo() 。 注 意 属 性 prop2 是 通过 getter getProp2() 和 setter 
setProp2() 定义 的 。 能 这 样 用 是 因为 yii\base\object 
此 祖先 类 支持 用 getter 和 setter 方法 定义 属性 


yii\base\Behavior 的 祖先 类 ， 


属性 访问 行为 已 附加 的 组 件 。 





[E: 


如 果 要 让 行为 响应 对 应 组 件 的 事件 触发 ， 就 应 履 写 yii\base\Behavior::events() 方法 ， 如 : 


1. namespace app\\components; 


3. Use yii\\db\\ActiveRecord; 
4. use yii\\base\\Behavior; 


6. Cclass MyBehavior extends Behavior 
{ 

8. // 其 它 代码 

10,， public function events() 

5 


12. return [ 
13. ActiveRecord: :EVENT_BEFORE_VALIDATE =&gt; "beforeVvValidate '， 
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15. } 

17. public function beforeValidate($event) 
18. { 

19, // 义理 器 方法 逻辑 

20. } 

21. } 


yii\base\Behavior::events()|events() 方法 返回 事件 列表 和 相应 的 处 理 器 。 上 例 声 明 了 
yii\db\ActiveRecord: :EVENT_BEFORE_VALIDATE|EVENT_BEFORE_VALIDATE 事件 和 它 的 处 理 


器 beforeValidate() 。 当 指 定 一 个 事件 处 理 器 时 ， 要 使 用 以 下 格式 之 一 : 


。 指向 行为 类 的 方法 名 的 字符 串 ， 如 上 例 所 示 ; 
e 对 象 或 类 名 和 方法 名 的 数组 ， 如 [$object, "methodName'] ; 
。 匿名 方法 。 


处 理 器 的 格式 如 下 ， 其 中 $event 指向 事件 参数 。 关 于 事件 的 更 多 细节 请 参考 事件 : 


1. function ($event) { 


2 


附加 行为 
可 以 静态 或 动 态 地 附加 行为 到 yii\base\Component | 组 件 。 前 者 在 实践 中 更 常 见 。 


要 静 态 附加 行为 ? 履 写 行为 要 附加 的 组 件 类 的 yii\base\Component: :behaviors()|behaviors() 
方法 即 可 。 yii\base\Component: :behaviors()|behaviors() 方法 应 该 返回 行为 配置 列表 。 每 个 
行为 配置 可 以 是 行为 类 名 也 可 以 是 配置 数组 。 如 : 


namespace app\\models; 


use yii\\db\\ActiveRecord; 
use app\\components\\MyBehavior,; 


class User extends ActiveRecord 


public function behaviors() 
{ 

return [ 

// 匿名 行为 ， 只 有 行为 类 名 
MyBehavior: :className(), 


// 命名 行为 ， 只 有 行为 类 名 
'myBehavior2' =&gt; MyBehavior::className(), 


// 匿名 行为 ， 配 置 数组 

[ 

"class' =&gt; MyBehavior::className(), 
"prop1' =&gt; 'valuel1', 

'prop2' =&gt; 'value2', 

]， 


// 命名 行为 ， 配 置 数组 

'myBehavior4' =&gt; [ 

"Class' =&gt; MyBehavior::className(), 
"prop1' =&gt; 'valuel1', 

'prop2' =&gt; 'value2', 


| 


通过 指定 行为 配置 数组 相应 的 键 可 以 给 行为 关联 一 个 名 称 。 这 种 行为 称 为 命名 行为 。 上 例 
中 ， 有 两 个 命名 行为 : myBehavior2 和 myBehavior4 。 如 果 行 为 没有 指定 名 称 就 是 匿名 行 


要 动态 附加 行为 ， 在 对 应 组 件 里 调用 yii\base\component::attachBehavior() 方法 即 可 ， 如 : 


Ib 


use app\\components\\MyBehavior,; 


// 附加 行为 对 象 


$component-&gt;attachBehavior('myBehavior1i', new MyBehavior); 


// 附加 行为 类 


$component-&gt;attachBehavior('myBehavior2', MyBehavior::className()); 


// 附加 配置 数组 
$component-&gt;attachBehavior('myBehavior3', 
'class' =&gt; MyBehavior::className(), 
"prop1' =&gt; 'valuel1', 

'prop2' =&gt; 'value2', 
]); 


[ 


可 以 通过 yii\base\Component::attachBehaviors() 方法 一 次 附加 多 个 行为 : 


ODPp 


$component-&gt;attachBehaviors([ 


'myBehavior1' =&gt; new MyBehavior， // 命名 行为 


MyBehavior: :className(), // 匿名 行为 
]) ; 


还 可 以 通过 配置 去 附加 行为 : 


be 

2.  'as myBehavior2' =&gt; MyBehavior::className(), 
4. "as myBehavior3' =&gt; [ 

5. 'class' =&gt; MyBehavior::className(), 

6. "prop1' =&gt; 'valuel1', 

7. ‘'prop2' =&gt; 'value2', 

8. 1], 

9. |] 


详情 请 参考 配置 章节 。 


J 二 、 
使 用 行为 
使 用 行为 ， 必 须 像 前 文 描述 的 一 样 先 把 它 附 加 到 yii\base\Component|component 类 或 其 子 
类 。 一 旦 行为 附加 到 组 件 ， 就 可 以 直接 使 用 它 。 


行为 附加 到 组 件 后 ， 可 以 通过 组 件 访问 一 个 行为 的 公共 成 员 变 量 或 getter 和 setter 方法 定义 
的 属性 : 


1. //“"prop1" 是 定义 在 行为 类 的 属性 
2. echo $component-&gt;prop1; 
3. $component-&gt;propl1 = $value; 


类 似 地 也 可 以 调用 行为 的 * 公 共 方 法 : 


1. // bar() 是 定义 在 行为 类 的 公共 方法 
2. $component-&gt;bar(); 


如 你 所 见 ， 尽 管 $component 未 定义 prop1 和 bar() ， 它 们 用 起 来 也 像 组 件 自己 定义 的 一 
样 。 


如 果 两 个 行为 都 定义 了 一 样 的 属性 或 方法 ， 并 且 它 们 都 附加 到 同一 个 组 件 ， 那 么 首先 附加 上 
的 行为 在 属性 或 方法 被 访问 时 有 优先 权 。 


附加 行为 到 组 件 时 的 命名 行为 ， 可 以 使 用 这 个 名 称 来 访问 行为 对 象 ， 如 下 所 示 : 


1. $behavior = $component-&gt;getBehavior('myBehavior'); 


也 能 获取 附加 到 这 个 组 件 的 所 有 行为 : 


1. $behaviors = $component-&gt;getBehaviors(); 


移 除 行为 


要 移 除 行为 ， 可 以 调用 yii\base\Component: :detachBehavior() 方法 用 行为 相关 联 的 名 字 实 
现 : 


1. $component-&gt;detachBehavior('myBehavior1'); 


也 可 以 移 除 全 部 行为 : 


1. $component-&gt;detachBehaviors(); 


使 用 TimestampBehavior 


最 后 以 yii\behaviors\TimestampBehavior 的 讲解 来 结尾 ， 这 个 行为 支持 在 
yii\db\ActiveRecord|Active Record 存储 时 自动 更 新 它 的 时 间 惟 属性 。 


首先 ， 附 加 这 个 行为 到 计划 使 用 该 行为 的 yii\db\ActiveRecord|Active Record 类 : 


1. namespace app\\models\\User,; 


3. Use yii\\db\\ActiveRecord; 
4. use yii\\behaviors\\TimestampBehavior; 


6. Cclass User extends ActiveRecord 


et 
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10., public function behaviors() 

Te 

12， return [ 

Tl 

14. 'class' =&gt; TimestampBehavior::className(), 


15. ‘'attributes' =&gt; [ 
16. ActiveRecord: :EVENT_BEFORE_INSERT =&gt; ['created at', 'updated at'], 
17. ActiveRecord::EVENT _ BEFORE UPDATE =&gt; ['updated at'], 


以 上 指定 的 行为 数组 : 
。 当 记 录 插 入 时 ， 行 为 将 当前 时 间 惟 赋值 给 created_at 和 updated_at 属性 ; 
。 当 记 录 更 新 时 ， 行 为 将 当前 时 间 戳 赋值 给 updated_at 属性 。 


保存 User 对 象 ， 将 会 发 现 它 的 created at 和 updated at 属性 自动 填充 了 当前 时 间 戳 : 


$user = new User; 

$user-&gt;email = 'test@example.com'; 
$user-&gt; save( ); 

echo $user-&gt;created at; // 显示 当前 时 间 徐 


yii\behaviors\TimestampBehavior |TimestampBehavior 行为 还 提供 了 一 个 有 用 的 方法 
yii\behaviors\TimestampBehavior::touch()|touch(),， 这 个 方法 能 将 当前 时 间 惟 赋值 给 指定 属 


性 并 保存 到 数据 库 : 


$user->touch('login time'); 


与 PHP traits 的 比较 

尽管 行为 在 "注入 " 属性 和 方法 到 主 类 方面 类 似 于 traits ， 它 们 在 很 多 方面 却 不 相同 。 如 上 所 
述 ， 它 们 各 有 利 业 。 它 们 更 像 是 互补 的 而 不 是 相互 替代 。 

行为 的 优势 

行为 类 像 普通 类 支持 继承 。 另 一 方面 ，traits 可 以 视 为 PHP 语言 支持 的 复制 粘贴 功能 ， 它 不 
支持 继承 。 

行为 无 须 修改 组 件 类 就 可 动态 附加 到 组 件 或 移 除 。 要 使 用 traits， 必 须 修改 使 用 它 的 类 。 
行为 是 可 配置 的 而 traits 不 能 。 

行为 以 响应 事件 来 自 定义 组 件 的 代码 执行 。 

当 不 同行 为 附加 到 同一 组 件 产生 命名 冲突 时 ， 这 个 冲突 通过 先 附 加 行为 的 优先 权 自 动 解 决 。 
而 由 不 同 traits 引发 的 命名 冲突 需要 通过 手工 重 命名 冲突 属性 或 方法 来 解决 。 

traits 的 优势 

traits 比 起 行为 更 高 效 ， 因 为 行为 是 对 象 ， 消 耗 时 间 和 内 存 。 


IDE 对 traits 更 友好 ， 因 为 它们 是 语言 结构 。 


配置 - Yii2 教 程 


配备 


在 Yii 中 ， 创 建新 对 象 和 初始 化 已 存在 对 象 时 广泛 使 用 配置 。 配 置 通常 包含 被 创建 对 象 的 类 名 
和 一 组 将 要 赋值 给 对 象 属性 的 初始 值 。 还 可 能 包含 一 组 将 被 附加 到 对 象 事件 上 的 句柄 。 和 一 
组 将 被 附加 到 对 象 上 的 行为 。 


以 下 代码 中 的 配置 被 用 来 创建 并 初始 化 一 个 数据 库 连 接 : 


1. $config = [ 

2 'class' =&gt; 'yii\\db\\Connection', 

3.  'dsn' =&gt; 'mysql:host=127.0.0.1;dbname=demo', 
4. 'usSername' =&gt; 'root', 

5 'password' =&gt; '', 

6 'charset' =&gt,; 'utf8', 

Zl 


9. $db = Yii::createObject($config); 


Yii::createOobject() 方法 接受 一 个 配置 并 根据 配置 中 指定 的 类 名 创建 对 象 。 对 象 实例 化 后 ， 
剩余 的 参数 被 用 来 初始 化 对 象 的 属性 ， 事 件 处 理 和 行为 。 


对 于 已 存在 的 对 象 ， 可 以 使 用 Yii::configure() 方法 根据 配置 去 初始 化 其 属性 ， 就 像 这 样 : 


1. Yii::configure(s$object, $config); 


请 注意 ， 如 果 配 置 一 个 已 存在 的 对 象 ， 那 么 配置 数组 中 不 应 该 包含 指定 类 名 的 class 元 素 。 


配置 的 格式 


一 个 配置 的 格式 可 以 描述 为 以 下 形式 : 


人 
2. 'class' =&gt; '" ClassName ' ， 
3. "propertyName' =&gt; "propertyValue '， 
4. "on eventName' =&gt; $eventHandler, 
5. ‘'as behaviorName' =&gt; $behaviorCconfig, 
6. |] 

其 中 


。 class 元 素 指定 了 将 要 创建 的 对 象 的 完全 限定 类 名 。 
。 propertyName 元 素 指定 了 对 象 属性 的 初始 值 。 键 名 是 属性 名 ， 值 是 该 属性 对 应 的 初始 
值 。 只 有 公共 成 员 变 量 以 及 通过 getter/setter 定义 的 属性 可 以 被 配置 。 


。 on eventName 元 素 指 定 了 附加 到 对 象 事件 上 的 句柄 是 什么 。 请 注意 ， 数 组 的 键 名 由 on 
前 缀 加 事件 名 组 成 。 请 参考 事件 章节 了 解 事件 句柄 格式 。 

。 as behaviorName 元 素 指 定 了 附加 到 对 象 的 行为 。 请 注意 ， 数 组 的 键 名 由 as 前 级 加 行为 
名 组 成 。$behaviorConfig 表示 创建 行为 的 配置 信息 ， 格 式 与 我 们 现在 总 体 叙 述 的 配置 格 
式 一 样 。 


下 面 是 一 个 配置 了 初始 化 属性 值 ， 事 件 句 柄 和 行为 的 示例 : 


到 

2. 'class' =&gt; 'app\\components\\SearchEngine', 
3. "apikey' =&gt; 'xxxxxxxx', 

4. "on search' =&gt; function ($event) { 

5. Yii::info( "搜索 的 关键 词 : " . $event-&gt;keyword); 
6. }, 

7. "as indexer' =&gt; [ 

8. 'class' =&gt; 'app\\components\\IndexerBehavior', 
9. // ..， 初始 化 属性 值 ... 

10. ]， 

11. ] 


使 用 配置 


Yii 中 的 配置 可 以 用 在 很 多 场景 。 本 章 开 头 我 们 展示 了 如 何 使 用 Yii::creatobject() 根据 配置 
信息 创建 对 象 。 本 小 节 将 介绍 配置 的 两 种 主要 用 法 配置 点 用 与 配置 小 部 件 。 





应 用 的 配置 


应 用 的 配置 可 能 是 最 复杂 的 配置 之 一 。 因 为 yii\web\Application|application 类 拥有 很 多 可 
配置 的 属性 和 事件 。 更 重要 的 是 它 的 yii\web\Application::components|components 属性 可 以 
接收 配置 数组 并 通过 应 用 注册 为 组 件 。 以 下 是 一 个 针对 基础 应 用 模板 的 应 用 配置 概要 : 


$config = [ 

'id' =&gt; 'basic', 

'basePath' =&gt; dirname(__DIR ), 

'extensions' =&gt; require( DIR . '/../vendor/yiisoft/extensions.php'), 
'components' =&gt; [ 

'cache' =&gt; [ 

'class' =&gt; 'yii\\caching\\FileCache', 
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"mailer' =&gt; [ 
10， 'class' =&gt; 'yii\\swiftmailer\\Mailer', 


12， 'log' =&gt; [ 

13. 'class' =&gt; 'yii\\log\\Dispatcher', 
14. 'traceLevel' =&gt; YII DEBUG ? 3 : 0, 
15. 'targets' =&gt; [ 

16. [ 

17. 'class' =&gt; 'yii\\log\\FileTarget', 


[en 
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21. 'db' =&gt; [ 

22. 'class' =&gt; 'yii\\db\\Connection', 

23, 'dsn' =&gt; 'mysql:host=localhost;dbname=stay2"', 
24. ‘'username' =&gt; 'root', 

25, 'password' =&gt; '', 

26,. 'charset' =&gt; "utf8 '， 


] 
28. ] 
] 


es 


配置 中 没有 class 键 的 原因 是 这 上段 配置 应 用 在 下 面 的 入 口 脚 本 中 ， 类 名 已 经 指定 了 。 


1. (new yii\\web\\Application($config))-&gt;run(); 
更 多 关于 应 用 components 属性 配置 的 信息 可 以 查阅 应 用 以 及 服务 定位 器 章节 。 


小 部 件 的 配置 


使 用 小 部 件 时 ， 常 常 需要 配置 以 便 自 定义 其 属性 。 yii\base\Widget::widget() 和 
yii\base\Widget::beginwidget() 方法 都 可 以 用 来 创建 小 部 件 。 它 们 可 以 接受 配置 数组 : 


1. use yii\\widgets\\Menu,; 

3. echo Menu::widget([ 

4. 'activateItems' =&gt; false, 

5. 'items' =&gt; [ 

6. ['label' =&gt; 'Home', 'uUrl' =&gt; [ "Site/index' ， 

7. ['label' =&gt; 'Products', 'url' =&gt; ['product/index' ， 

8. ['label' =&gt; 'Login', 'url' =&gt; ['site/login'], 'visible' =&gt; Yii::$app-&gt;use 
9. ]， 

T0000l 


到 天 = 于 3 


上 述 代 码 创 建 了 一 个 小 部 件 menu 并 将 其 activateItems 属性 初始 化 为 false。 item 属性 也 
配置 成 了 将 要 显示 的 菜单 条 目 。 





请 注意 ， 代 码 中 已 经 给 出 了 类 名 yii\widgets\Menu ， 配 置 数 组 不 应 该 再 包含 class 键 。 


配置 文件 


当 配 置 的 内 容 十 分 复杂 ， 通 用 做 法 是 将 其 存储 在 一 或 多 个 PHP 文件 中 ， 这 些 文件 被 称 为 配置 
文件 。 一 个 配置 文件 返回 的 是 PHP 数组 。 例 如 ， 像 这 样 把 应 用 配置 信息 存储 在 名 为 ”web.php 
的 文件 中 : 


1. return [ 

2. 'id' =&gt; 'basic'， 

3. 'basePath' =&gt; dirname(_DIR__ )， 

4. "extenslions' =&gt; require(_ DIR . '/../vendor/yiisoft/extensions.php'), 
5. ‘'components' =&gt; require(_ DIR . '/components.php'), 

6. 


J]; 


鉴于 components 配置 也 很 复杂 ， 上 述 代码 把 它们 存储 在 单独 的 components.php 文件 中 ， 并 
且 包 含 在 web .php 里 。 components .php 的 内 容 如 下 : 


return [ 

'cache' =&gt; [ 

'class' =&gt; 'yii\\caching\\FileCache', 
]， 

'mailer' =&gt; 

'class' =&gt; 'yii\\swiftmailer\\Mailer', 


]， 

'l0g' =&gt; [ 

'class' =&gt; 'yii\\log\\Dispatcher', 
10， 'traceLevel' =&gt; YII DEBUG ? 3 : 0, 
11. 'targets' =&gt; [ 
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T2000 
13， 'class' =&gt; 'yii\\log\\FileTarget', 
Ta 
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16. ]， 


17. 'db' =&gt; [ 

18. 'class' =&gt; 'yii\\db\\Connection', 

19. 'dsn' =&gt; 'mysql:host=localhost;dbname=stay2"', 
20. "username' =&gt; 'root', 

21， 'password' =&gt; '', 

22, 'charset' =&gt; "utf8 '， 

23:00 1 

24500|]; 


仅仅 需要 “require”， 就 可 以 取得 一 个 配置 文件 的 配置 内 容 ， 像 这 样 : 


1. $config = require('path/to/web.php'); 
2. (new yii\\web\\Application($config))-&gt;run(); 


默认 配置 


Yii::createobject() 方法 基于 依赖 注入 容器 实现 。 使 用 Yii::creatobject() 创建 对 象 时 ， 
可 以 附加 一 系列 黑 认 配置 到 指定 类 的 任何 实例 。 黑 认 配 置 还 可 以 在 入 口 脚 本 中 调用 


Yii::$container-&gt;set() 来 定义 。 


例如 ， 如 果 你 想 自 定义 yii\widgets\LinkPager 小 部 件 ， 以 便 让 分 页 器 最 多 只 显示 5 个 翻 页 
按钮 (默认 是 10 个 )， 你 可 以 用 下 述 代码 实现 : 


1. \\Yii::$container-&gt;set('yii\\widgets\\LinkPager', [ 
2. "maxButtonCount' =&gt; 5, 
3. ])) 


不 使 用 默认 配置 的 话 ， 你 就 得 在 任何 使 用 分 页 器 的 地 方 ， 都 配置 maxButtoncount 的 值 。 


环境 贡 量 


配置 经 常 要 随 着 应 用 运行 的 不 同 环境 更 改 。 例 如 在 开发 环境 中 ， 你 可 能 使 用 名 为 mydb_dev 
的 数据 库 ， 而 生产 环境 则 使 用 mydb_prod 数据 库 。 为 了 便于 切换 使 用 环境 ，Yii 提供 了 一 个 定 
义 在 入 口 脚本 中 的 YiII_ENv 常量 。 如 下 : 


1. defined('YII ENV') or define('YII ENV', 'dev'); 


你 可 以 把 Yrr_ENv 定义 成 以 下 任何 一 种 值 : 


。 prod : 生产 环境 。 常 量 Yll ENV_PROD 将 被 看 作 true。 如 果 你 没 修改 过 ， 这 就 是 
YILENYV 的 默认 值 。 

。 dev : 开发 环境 。 常 量 Yll_ENV_DEYV 将 被 看 作 true。 

。 test : 测试 环境 。 常 量 YIL_ENV_TEST 将 被 看 作 true。 


有 了 这 些 环境 常量 ， 你 就 可 以 根据 当下 应 用 运行 环境 的 不 同 ， 进 行 差 异化 配置 。 例 如 ， 应 用 
可 以 包含 下 述 代码 只 在 开发 环境 中 开启 调试 工具 。 


1. $config = [...]; 

3. if (YII_ENV_DEV) { 

4. // 根据 `dev” 环境 进行 的 配置 调整 

5. $config['bootstrap'][] = 'debug'; 

6. $config['modules']['debug'] = 'yii\\debug\\Module'; 
7 

9. return $config; 


别名 (Aliases) - Yii2 教 程 


别名 (Aliases) 


别名 用 来 表示 文件 路 径 和 URL， 这 样 就 避免 了 在 代码 中 硬 编码 一 些 绝对 路 径 和 URL。 一 个 别 
名 必须 以 @ 字符 开头 ， 以 区 别 于 传统 的 文件 路 径 和 URL。Yii 预 定义 了 大 量 可 用 的 别名 。 例 
如 ， 别 名 @yii 指 的 是 Yii 框架 本 身 的 安装 目录 ， 而 6@web 表示 的 是 当前 运行 应用 的 根 
URL。 


py < 

定义 别名 

你 可 以 调用 Yii::setAlias() 来 给 文件 路 径 或 URL 定义 别名 : 
1. // 文件 路 径 的 别名 


2. Yii::setAlias('@foo', '/path/to/foo'); 


// URL 的 别名 
Yii::setAlias('@bar', 'http://www.example.com'); 


JUI 人 








注意 : 别名 所 指向 的 文件 路 径 或 URL 不 一 定 是 真实 存在 的 文件 或 资源 。 





可 以 通过 在 一 个 别名 后 面 加 斜 枉 / 和 一 至 多 个 路 径 分 段 生 成 新 别名 (无 需 调 用 
Yii::setAlias() )。 我 们 把 通过 Yii::setAlias() 定义 的 别名 称 为 根 别 名 ， 而 用 他 们 衍生 出 
去 的 别名 成 为 衍生 别名 。 例 如 ， @foo 就 是 跟 别 名 ， 而 @foo/bar/file.php 是 一 个 衍生 别 
名 。 


你 还 可 以 用 别名 去 定义 新 别名 ( 根 别名 与 衍生 别名 均 可 ) : 


1. Yii::setAlias('@foobar', '@foo/bar'); 


根 别 名 通常 在 引导 阶段 定义 。 上 比如 你 可 以 在 入 口 脚本 里 调用 Yii::setAlias() 。 为 了 方便 起 
见 ， 应 用 提供 了 一 个 名 为 aliases 的 可 写 属性 ， 你 可 以 在 应 用 配置 中 设置 它 ， 就 像 这 样 : 


return [ 

CA 

'aliases' =&gt; [ 

'@foo' =&gt; '/path/to/foo', 

'@bar' =&gt; 'http://www.example.com', 


] 
J]; 
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解析 别名 


你 可 以 调用 Yii::getAlias() 命令 来 解析 根 别 名 到 对 应 的 文件 路 径 或 URL。 同 样 的 页 面 也 可 
以 用 于 解析 衍生 别名 。 例 如 : 


1. echo Yii::getAlias('@foo'); // 输出 : /path/to/foo 
2. echo Yii::getAlias('@bar'); // 输出 :http://www.example.com 
3. echo Yii::getAlias('@foo/bar/file.php'); // 输出 :/path/to/foo/bar/file.php 


由 衍生 别名 所 解析 出 的 文件 路 径 和 URL 是 通过 蔡 换 掉 衍 生 别 名 中 的 根 别 名 部 分 得 到 的 。 


区 
网 
AN 
中 


注意 : Yii::getAlias() 并 不 格 占 果 路 径 /URL 所 指向 的 资源 是 否 真实 存在 。 





根 别 名 可 能 也 会 包含 斜 枉 / 。 vii::getAlias() 足够 智能 到 判断 一 个 别名 中 的 哪 部 分 是 根 别 
名 ， 因 此 能 正确 解析 文件 路 径 /URL。 例 如 : 


Yii::setAlias('@foo', '/path/to/foo'); 

Yii::setAlias('@foo/bar', '/path2/bar'); 

echo Yii::getAlias('@foo/test/file.php'); // 输出 :/path/to/foo/test/file.php 
echo Yii::getAlias('@foo/bar/file.php'); // 输出 : /path2/bar/file.php 
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若 efoo/bar 未 被 定义 为 根 别 名 ， 最 后 一 行 语句 会 显示 为 /path/to/foo/bar/file.php 。 


使 用 别名 


别名 在 Yii 的 很 多 地 方 都 会 被 正确 识别 ， 无 需 调 用 Yii::getAlias() 来 把 它们 转换 为 路 
径 /URL。 例如 ， yii\caching\FileCache::cachepath 能 同时 接受 文件 路 径 或 是 指向 文件 路 径 的 
别名 ， 因 为 通过 @ 前 级 能 区 分 它们 。 


1. Use yii\\caching\\FileCache,; 


CD 


$cache = new FileCache([ 
4. 'cachePath' =&gt; '@runtime/cache', 


5. 1]); 


请 关注 API 文档 了 解 特 定 属性 或 方法 参数 是 否 支 持 别名 。 


预定 义 的 别名 
Yii 预定 义 了 一 系列 别名 来 简化 常用 路 径 和 URL 的 使 用 : 


。 @yii - BaseYii.php 文件 所 在 的 目录 (也 被 称 为 框架 安装 目录 ) 
。 @app - 当前 运行 的 应 用 yii\base\Application: :basePath| 根 路 径 (base path) 
。 @runtime - 当前 运行 的 应 用 的 yiixbase\Application: :runtimePath| 运 行 环境 (runtime) 路 径 





e。 vendor - yii\base\Application::vendorPath|Composer 供应 商 目 录 
。 @webroot - 当前 运行 应 用 的 Web 入 口 目 录 
@web - 当前 运行 应 用 的 根 URL 


@yii 别名 是 在 入 口 脚本 里 包含 Yii.php 文件 时 定义 的 ， 其 他 的 别名 都 是 在 配置 应 用 的 时 
候 ， 于 应用 的 构造 方法 内 定义 的 。 

扩展 的 别名 

每 一 个 通过 Composer 安装 的 扩展 都 自动 添加 了 一 个 别名 。 该 别名 会 以 该 扩展 在 
composer.json 文件 中 所 声明 的 根 命名 空间 为 名 ， 且 他 直接 代 指 该 包 的 根 目 录 。 例 如 ， 如 果 
你 安装 有 yiisoft/yii2-jui 扩展 ， 会 自动 得 到 @yii/jui 别名 ， 它 定义 于 引导 启动 阶段 : 


1. Yii::setAlias('@yii/jui', 'Vendorpath/yiisoft/yii2-jui'); 


服务 定位 器 - Yii2 教 程 
服务 定位 器 


服务 定位 器 是 一 个 了 解 如 何 提供 各 种 应 用 所 需 的 服务 (或 组 件 ) 的 对 象 。 在 服务 定位 器 中 ， 每 个 
组 件 都 只 有 一 个 单独 的 实例 ， 并 通过 ID 唯一 地 标识 。 用 这 个 ID 就 能 从 服务 定位 器 中 得 到 这 个 
组 件 。 


在 Yii 中 ， 服 务 定位 器 是 yii\di\serviceLocator 或 其 子 类 的 一 个 实例 。 


最 常用 的 服务 定位 器 是 application( 应 用 ) 对 象 ， 可 以 通过 \Yii::$app 访问 。 它 所 提供 的 服务 
被 称 为 application components( 应 用 组 件 )， 上 比如 : request 、 response 、 urlManager 组 

件 。 可 以 通过 服务 定位 器 所 提供 的 功能 ， 非 常 容易 地 配置 这 些 组 件 ， 或 其 至 是 用 你 自己 的 实 

现 蔡 换 掉 他 们 。 


除了 application 对 象 ， 每 个 模块 对 象 本 身 也 是 一 个 服务 定位 器 。 


要 使 用 服务 定位 器 ， 第 一 步 是 要 注册 相关 组 件 。 组 件 可 以 通过 yii\di\serviceLocator::set() 
方法 进行 注册 。 以 下 的 方法 展示 了 注册 组 件 的 不 同方 法 : 

1. use yii\\di\\ServiceLocator,; 

2. Use yii\\caching\\FileCache,; 

4. $locator = new ServiceLocator; 


6. // 通过 一 个 可 用 于 创建 该 组 件 的 类 名 ， 注 册 "cache" (缓存 ) 组 件 。 
7. $locator-&gt;set('cache', 'yii\\caching\\ApcCache'); 











9. // 通过 一 个 可 用 于 创建 该 组 件 的 配置 数组 ， 注 册 "db" (数据 库 ) 组 件 。 
10,. $locator-&gt;set('db', [ 

11. "class' =&gt; 'yii\\db\\Connection', 

12. 'dsn' =&gt; 'mysql:host=localhost;dbname=demo', 





13. "username' =&gt; 'root', 
14. 'password' =&gt; '', 
15. ]); 


17,， // 通过 一 个 能 返回 该 组 件 的 匿名 画 数 ， 注 册 "search" 组 件 。 
18. $locator-&gt;set('search', function () { 

19,. return new app\\components\\SolrService; 

2000 人 六 


22， // 用 组 件 注 册 "pageCcache" 组 件 
23, $locator-&gt;set('pageCache', new FileCache); 


一 且 组 件 被 注册 成 功 ， 你 可 以 任 选 以 下 两 种 方式 之 一 ， 通 过 它 的 1D 访问 它 : 


1. $cache = $locator-&gt;get('cache'); 
2. // 或 者 


3. $cache = $locator-&gt;cache; 


如 上 所 示 ， yii\di\serviceLocator 人 允许 通过 组 件 ID 像 访问 一 个 属性 值 那样 访问 一 个 组 件 。 
当 你 第 一 次 访问 某 组 件 时 ， yii\di\ServiceLocator 会 通过 该 组 件 的 注册 信息 创建 一 个 该 组 件 
的 实例 ， 并 返回 它 。 之 后 ， 如 果 再 次 访问 ， 则 服务 定位 器 会 返回 同一 个 实例 。 


你 可 以 通过 yii\di\ServiceLocator::has() 检查 某 组 件 ID 是 否 被 注册 。 若 你 用 一 个 无 效 的 ID 
调用 yii\di\ServiceLocator::get(),， 则 会 抛 出 一 个 异常 。 


因为 服务 定位 器 ， 经 常会 在 创建 时 附带 配置 信息 ， 因 此 我 们 提供 了 一 个 可 写 的 属性 ， 名 为 
yii\di\ServiceLocator::setCcomponents()|components ， 这 样 就 可 以 配置 该 属性 ， 或 一 次 性 注册 
多 个 组 件 。 下 面 的 代码 展示 了 如 何 用 一 个 配置 数组 ， 配 置 一 个 应 用 并 注册 "db"，"cache" 和 
"search" 三 个 组 件 : 


return [ 

A 

'components' =&gt; [ 

'db' =&gt; [ 

'class' =&gt; 'yii\\db\\Connection', 
'dsn' =&gt; 'mysql:host=localhost;dbname=demo', 
'Username' =&gt; 'root', 

'password' =&gt; '', 

]， 

10. 'cache' =&gt; 'yii\\caching\\ApcCache', 
11. 'search' =&gt; function () { 

12. return new app\\components\\SolrService,; 
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依赖 注入 容器 - Yii2 教 程 
依赖 注入 容器 


依赖 注入 (Dependency Injection，D1) 容 器 就 是 一 个 对 象 ， 它 知道 怎样 初始 化 并 配置 对 象 及 其 
依赖 的 所 有 对 象 。Martin 的 文章 已 经 解释 了 DI 容器 为 什么 很 有 用 。 这 里 我 们 主要 讲解 Yii 提 
供 的 DI 容器 的 使 用 方法 。 


依赖 注入 
Yii 通过 yii\di\container 类 提供 DI 容器 特性 。 它 支持 如 下 几 种 类 型 的 依赖 注入 : 


e。 构造 方法 注入 ; 
。 Setter 和 属性 注入 ; 
。 PHP 回调 注入 . 


构造 方法 注入 


在 参数 类 型 提示 的 帮助 下 ，DI 容器 实现 了 构造 方法 注 人 。 当 容器 被 用 于 创建 一 个 新 对 象 时 ， 
类 型 提示 会 告诉 它 要 依赖 什么 类 或 接口 。 容 器 会 尝试 获取 它 所 依赖 的 类 或 接口 的 实例 ， 然 后 
通过 构造 器 将 其 注入 新 的 对 象 。 例 如 : 


1. class Foo 

2 

3. public function __construct(Bar $bar) 
2 

Se 

6. } 


8. $foo = $container-&gt;get('Foo'); 
9. // 上 面 的 代码 等 价 于 : 

10. $bar = new Bar 

11. $foo = new Foo($bar); 


Setter 和 属性 注入 


Setter 和 属性 注入 是 通过 配置 提供 支持 的 。 当 注册 一 个 依赖 或 创建 一 个 新 对 象 时 ， 你 可 以 提 
供 一 个 配置 ， 该 配置 会 提供 给 容器 用 于 通过 相应 的 Setter 或 属性 注入 依赖 。 例 如 : 


1. Use yii\\base\\0bject; 
3. Class Foo extends Object 
5 ne $bar; 

7. private $_qux; 


9. public function getQux() 


11. return $this-&gt;_qux; 

2 

14. public function setQux(Qux $qux) 
15. { 

16. $this-&gt;_qux = $qux; 

7 

18. } 


20, $container-&gt;get('Foo', [], [ 

21. 'bar' =&gt; $container-&gt;get('Bar'), 
22, 'gux' =&gt; $container-&gt;get('QUux'), 
23. ]); 


PHP 回调 注入 


这 种 情况 下 ， 容 器 将 使 用 一 个 注册 过 的 PHP 回调 创建 一 个 类 的 新 实例 。 回 调 负责 解 决 依赖 并 
将 其 恰当 地 注入 新 创建 的 对 象 。 例 如 : 
1. $container-&gt;set('Foo', function () { 


2. return new Foo(new Bar); 


3. 7}); 


5. $foo = $container-&gt;get('Foo'); 


注册 依赖 天 系 


可 以 用 yii\di\Container::set() 注册 依赖 关系 。 注册 会 用 到 一 个 依赖 关系 名 称 和 一 个 依赖 关 
系 的 定义 。 依 赖 关 系 名 称 可 以 是 一 个 类 名 ， 一 个 接口 名 或 一 个 别名 。 依 赖 关系 的 定义 可 以 是 
一 个 类 名 ， 一 个 配置 数组 ， 或 者 一 个 PHP 回调 。 


1. $container = new \\yii\\di\\Container; 


3. // 注册 一 个 同类 名 一 样 的 依赖 关系 ， 这 个 可 以 省 略 。 
4. $container-&gt;set('yii\\db\\Connection'); 


6. // 注册 一 个 接口 
7. // 当 一 个 类 依赖 这 个 接口 时 ， 相 应 的 类 会 被 初始 化 作为 依赖 对 象 。 
8. $container-&gt;set('yii\\mail\\MailInterface', 'yii\\swiftmailer\\Mailer'); 


10. // 注册 一 个 别名 。 
11. // 你 可 以 使 用 $container-&gt;get('foo') 创建 一 个 Connection 实例 
12,. $container-&gt;set('foo', 'yii\\db\\Connection'); 


14. // 通过 配置 注册 一 个 类 

15. // 通过 get() 初始 化 时 ， 配 置 将 会 被 使 用 。 

16. $container-&gt;set('yii\\db\\Connection', [ 

17., 'dsn' =&gt; 'mysql:host=127.0.0.1;dbname=demo', 
18. ‘'UusSername' =&gt; 'root', 

19, 'password' =&gt; '', 

20, 'charset' =&gt; "utf8 '， 

21. 1]); 


23， // 通过 类 的 配置 注册 一 个 别名 

24. // 这 种 情况 下 ， 需 要 通过 一 个 “class” 元 素 指定 这 个 类 
25,. $container-&gt;set('db', [ 

26. 'class' =&gt; 'yii\\db\\Connection', 

27, 'dsn' =&gt; 'mysql:host=127.0.0.1;dbname=demo', 
28， ‘'Username' =&gt; 'root', 

29, 'password' =&gt; '', 

30, 'charset' =&gt; "utf8 '， 

31. 1]); 


33. // 注册 一 个 PHP 回调 

34. // 每 次 调用 $container-&gt;get('db') 时 ， 回 调 画 数 都 会 被 执行 。 

35, $container-&gt;set('db', function ($container, $params, $config) { 
36. return new \\yii\\db\\Connection($config); 

37. }); 


39. // 注册 一 个 组 件 实例 
40. // $container-&gt;get('pageCache') 每 次 被 调用 时 都 会 返回 同一 个 实例 。 
41. $container-&gt;set('pageCache', new FileCache); 








Tip: 如 果 依赖 关系 名 称 和 依赖 关系 的 定义 相同 ， 则 不 需要 通过 DI 容器 注册 该 依赖 关系 。 


通过 set() 注册 的 依赖 关系 ， 在 每 次 使 用 时 都 会 产生 一 个 新 实例 。 可 以 使 用 
yii\di\Container::setSingleton() 注册 一 个 单 例 的 依赖 关系 : 


$container-&gt;setSingleton('yii\\db\\Connection', [ 
'dsn' =&gt; 'mysql:host=127.0.0.1;dbname=demo', 
'Username' =&gt; 'root', 

'password' =&gt; '', 

'charset' =&gt; 'utf8', 

1]); 


OODP 


解决 依赖 关系 


注册 依赖 关系 后 ， 就 可 以 使 用 DI 容器 创建 新 对 象 了 。 容 器 会 自动 解决 依赖 关系 ， 将 依赖 实例 
化 并 注入 新 创建 的 对 象 。 依 赖 关系 的 解决 是 北 为 的 ， 如 果 一 个 依赖 关系 中 还 有 其 他 依赖 关 
系 ， 则 这 些 依赖 关系 都 会 被 自动 解决 。 


可 以 使 用 yii\di\container::get() 创建 新 的 对 象 。 该 方法 接收 一 个 依赖 关系 名 称 ， 它 可 以 是 
一 个 类 名 ， 一 个 接口 名 或 一 个 别名 。 依赖 关系 名 或 许 是 通过 set() 或 setsingleton() 注册 
的 。 你 可 以 随意 地 提供 一 个 类 的 构造 器 参数 列表 和 一 个 configuration 用 于 配置 新 创建 的 对 
象 。 例 如 : 


1. // "db" 是 前 面 定义 过 的 一 个 别名 
2. $db = $container-&gt;get('db'); 


Op 


// 等 价 于 : $engine = new \\app\\components\\SearchEngine($apikey, ['type' =&gt; 1]); 
$engine = $container-&gt;get('app\\components\\SearchEngine', [$apikKey], ['type' =&gt 








代码 背后 ，DI 容器 做 了 上 比 创建 对 象 多 的 多 的 工作 。 容 器 首先 将 检查 类 的 构造 方法 ， 找 出 依赖 
的 类 或 接口 名 ， 然 后 自动 递归 解决 这 些 依赖 关系 。 


如 下 代码 展示 了 一 个 更 复杂 的 示例 。 userLister 类 依赖 一 个 实现 了 UserFinderInterface 接 
口 的 对 象 ; userFinder 类 实现 了 这 个 接口 ， 并 依赖 于 一 个 connection 对 象 。” 所 有 这 些 依赖 
关系 都 是 通过 类 构造 器 参数 的 类 型 提示 定义 的 。 通 过 属性 依赖 关系 的 注册 ，DI 容器 可 以 自动 
解决 这 些 依赖 关系 并 能 通过 一 个 简单 的 get('userLister') 调用 创建 一 个 新 的 UserLister 实 
例 。 


1. namespace app\\models; 
3. Use yii\\base\\0Object; 
4. use yii\\db\\Connection; 
5 use yii\\di\\Container,; 


interface UserFinderInterface 


function findUser(); 


0. } 

12,. class UserFinder extends Object implements UserFinderInterface 
{ 

14. public $db; 


16. public function __construct(Connection $db, $config = []) 


lr 

18. $this-&gt;db = $db; 

19, parent:: construct($config); 
20. } 

22. public function findUser() 
DR 

24. } 

25. } 


27. Cclass UserLister extends Object 
{ 
29, public $finder; 
31. public function __construct(UserFinderIinterface $finder, $config = []) 


{ 
33, $this-&gt;finder = $finder,; 


34, parent:: construct($config); 
35. } 
36. } 


38. $container = new Container; 

39, $container-&gt;set('yii\\db\\Connection', [ 

和 40 dsnan =&ot 0 0 

41. ]); 

42. $container-&gt;set('app\\models\\UserFinderIinterface', [ 

43. 'class' =&gt; 'app\\models\\UserFinder', 

44. 1); 

45. $container-&gt;set('userLister', 'app\\models\\UserLister'); 


47. $lister = $container-&gt;get('userLister'); 
49. // 等 价 于 : 
51. $db = new \\yii\\db\\Connection(['dsn' =&gt; '...']); 


52, $finder = new UserFinder($db); 
53. $lister = new UserLister($finder); 


实践 中 的 运用 


当 在 应 用 程序 的 入 口 脚本 中 引入 Yii.php 文件 时 ，Yii 就 创建 了 一 个 DI 容器 。 这 个 DI 容器 
可 以 通过 Yii::$container 访问 。 当 调用 Yii::createobject() 时 ， 此 方法 实际 上 会 调用 这 
个 容器 的 yii\di\Container::get()lget() 方法 创建 新 对 象 。 如 上 所 述 ， DI 容器 会 自动 解决 依 
赖 关系 (如 果 有 ) 并 将 其 注入 新 创建 的 对 象 中 。 因 为 Yii 在 其 多 数 核心 代码 中 都 使 用 了 
Yii::createobject() 创建 新 对 象 ， 所 以 你 可 以 通过 Yii::$container 全 局 性 地 自 定义 这 些 对 
象 。 


例如 ， 你 可 以 全 局 性 自 定 义 yii\widgets\LinkPager 中 分 页 按钮 的 默认 数量 : 


1. \\Yii::$container-&gt;set('yii\\widgets\\LinkPager', ['maxButtonCount' =&gt; 5]); 


这 样 如 果 你 通过 如 下 代码 在 一 个 视图 里 使 用 这 个 挂件 ， 它 的 maxButtonCount 属性 就 会 被 初始 
化 为 5 而 不 是 类 中 定义 的 默认 值 10。 


1. echo \\yii\\widgets\\LinkPager::widget(); 


然而 你 依然 可 以 覆盖 通过 DI 容器 设置 的 值 : 


1. echo \\yii\\widgets\\LinkPager::widget(['maxButtonCount' =&gt; 20]); 


另 一 个 例子 是 借用 DI 容器 中 自动 构造 0 来 的 好 处 。 假 设 你 的 控制 器 类 依赖 一 些 其 他 
对 象 ， 例 如 一 个 旅馆 预订 服务 。 你 可 以 通过 一 个 构造 器 参数 声明 依赖 关系 ， 然 后 让 DI 容器 帮 
你 自动 解决 这 个 依赖 关系 。 


1. namespace app\\controllers; 


3. use yii\\web\\Controller; 
4. Use app\\components\\BookingInterface; 


6. Class HotelController extends Controller 
8. protected $bookingService; 
10. public function _ construct($id, $module, BookingInterface $bookingService, $config 


12,. $this-&gt;bookingService = $bookingService,; 
13. parent:: construct($id, $module, $config); 





如 果 你 从 浏览 器 中 访问 这 个 控制 器 ， 你 将 看 到 一 个 报错 信息 ， 提 醒 你 BookingInterface 无 法 
被 实例 1 化。 这 是 因为 你 需 告诉 DI 容器 怎样 处 理 这 个 依赖 关系 。 


1. \\Yii::$container-&gt;set('app\\components\\BookingInterface', 'app\\components\\Book 





现在 如 果 你 再 次 访问 这 个 控制 器 ， 一 个 app\components\Bookingservice 的 实例 就 会 被 创建 并 
被 作为 第 三 个 参数 注入 到 控制 器 的 构造 器 中 。 


么 时 候 注 册 依 赖 天 系 


由 于 依赖 关系 在 创建 新 对 象 时 需要 解决 ， 因 此 它们 的 注册 应 该 尽早 完成 。 如 下 是 推荐 的 实 
践 : 


。 如 果 你 是 一 个 应 用 程序 的 开发 者 ， 你 可 以 在 应 用 程序 的 人 口 脚本 或 者 被 人 口 脚本 引入 的 


脚本 中 注册 依赖 关系 。 
。 如 果 你 是 一 个 可 再 分 发 扩展 的 开发 者 ， 你 可 以 将 依赖 关系 注册 到 扩展 的 引导 类 中 。 
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依赖 注入 和 服务 定位 器 都 是 流行 的 设计 模式 ， 它 们 使 你 可 以 用 充分 解 耦 且 更 利于 测试 的 风格 
构建 软件 。 强 烈 推 荐 你 阅读 Martin 的 文章 ， 对 依赖 注入 和 服务 定位 器 有 个 更 深入 的 理解 。 


Yii 在 依赖 住人 (DN) 容 器 之 上 实现 了 它 的 服务 定位 器 。 当 一 个 服务 定位 器 党 试 创建 一 个 新 的 对 
象 实例 时 ， 它 会 把 调用 转发 到 DI 容器 。 后 者 将 会 像 前 文 所 述 那样 自动 解决 依赖 关系 。 


